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Preface 


At the very heart of your Oric Atmos or Oric-1 microcomputer is an inconspicuous chip 
called the 6502 microprocessor. It is responsible for co-ordinating every single thing your 
Oric docs all the time it is switched on—no mean feat! However, no matter what 
preconceptions you may have, programming the Oric at its own machine code level is not 
difficult—and that is the very aim of this book—to teach you just how to develop and 
write your own machine code programs. 

The text assumes that you have some knowledge of Oric BASIC but know absolutely 
nothing about machine code, though you will probably have read the machine code 
chapter in the Oric Atmos Manual or Oric-1 BASIC Programming Manual. have tried very 
hard to write in non-technical language and set the chapters out in a logical manner, 
introducing new concepts in digestible pieces as and when they are needed rather than 
devoting chapters to specific items. Wherever possible, practical programs are included to 
bring home the point being made, and in most instances these are analysed and the 
function and operation of each instruction explained. 

Machine Code for the Atmos and Oric-1 is completely self-contained and includes a full 
description of all the machine code instructions available and suggests suitable 
applications for their use. Aftera ‘bit of theory’ in the opening chapters, the main registers 
of the 65@2 are introduced and descriptions given of how, when and where machine code 
routines can be entered. There is also a simple machine code monitor program which 
facilitates the entry of such routines. 

After discussing the way in which the 6502 flags certain conditions to the outside world, 
some of the modes of addressing the chip are described. Machine code addition and 
subtraction are introduced and the easiest ways of manipulating and saving data for 
future use by the program and processor are described. Machine code loops (equivalent to 
BASIC’s FOR... NEXT...STEP...) show how sections of code may be repeated, and 
subroutines and jumps take the place of BASIC’s GOSUB and GOTO. Also included is 
a look at some more complicated procedures, such as multiplication and division using 
the shift and rotate instructions. 

Finally, the Appendices provide a quick and easy reference to the sorts of things you'll 
need to ‘want to know quickly’ when you start writing your very own original machine 
code programs! 


Highbury, November 1983 Bruce Smith 


| Machine Code or 
Assembly Language? 


The 6502 microprocessor within your Oric microcomputer can perform 152 different 
operations, with each one being defined by a number (or operation code) in the range @ to 
255 (see Appendix 5). To create a machine code program we need simply to POKE 
successive memory locations with the relevant operation codes—‘opcodes’ for short. For 
example, to store the value 5 into location #1560 (in other words to do the machine code 


equivalent of BASIC’s POKE #1506, 5), we would need to POKE the following bytes into 
memory: 


HAY 
#05 
#8D 
OO 
#15 
and then ask the Oric’s 6502 to execute them. 

Not exactly clear is it! That’s where assembly language comes in. 

Assembly language allows us to write machine code in an abbreviated form which is 
designed to represent the actual operation the opcode will perform. This abbreviated form 
is known as a »inemonic and it is the basic building block of assembly language (or 
assembler) programs. 

We could rewrite the previous machine code in assembler like this: 

LDA @5 
STA #1500 


and it can be read as: 


Load the accumulator with the value 5 


Store the accumulator’s contents at location #1500 


As you can see from the bold letters, the mnemonic is composed of letters in the 
instruction, which greatly enhances its readability. 

Once the assembler program is complete, it can be converted into machine code in one 
of two ways. 


1. With the aid of a mmemonic assembler. This is itself a program (written in machine 
code or BASIC) which transforms the assembly language instructions (known as the 
source) into machine code (known as the object code) and POKEs them into memory 
as it does so. Commercial versions will no doubt be forthcoming as the Oric increases 
in popularity. 


2. By looking up the relative codes in a table and then POKEing them into memory 


using a monitor program or a DATA-reading FOR . . . NEXT loop. Full details of 
this method are given in Chapter 5, which also includes a simple monitor program. 


All the programs in this book are listed in both their assembler and machine code forms, so 
they can be entered by either of the above methods. 
Appendix 3 provides comprehensive user information about all of the 6502's opcodes, 


so don’t worry too much if some of this seems a bit foreign at the moment—we'll soon 
change that! 


WHY MACHINE CODE? 


Why bother to talk to the Oric in its own language? There are really two main reasons. 
Firstly speed. Machine code is executed very much faster than a high level language such 
as BASIC. Remember that the BASIC interpreter ts itself written in machine code and the 
BASIC statements and commands are simply pointers to routines within the BASIC 
ROM. However, because each statement and command must be interpreted and located 
Within the ROM, a decrease in operation speed occurs. Secondly, learning machine code 
allows you to understand just how your computer works, and lets you create special 
effects and routines not possible within the constraints imposed by the limited set of 


BASIC instructions. Machine code allows you to control your Oric, rather than it 
controlling you! 


2 Numbers 


BINARY, HEX AND DECIMAL 


We have seen that the instructions the Oric operates with consist of sequences of 
numbers. But just how are these numbers stored internally? Well, not wishing 
to baffle you with the wonders of modern computer science, let's try to simplify 
matters somewhat and say that each instruction is stored internally as a binary number. 
Decimal numbers are composed of combinations of ten different digits, that is @,1,2,3,4, 
5,6, 7,8 and 9 and are said to work to a base of 10. As its name suggests, binary numbers 
work to a base of 2 where only the digits @ and | are available. These two numbers 
represent the two different electrical conditions that are available inside the Oric, 
namely @ volts (off) and 5 volts (on). 
The machine code already described is therefore represented internally as: 


Mnemonic Machine code Binary 
LDA A9 10161601 
@#5 05 06060101 
STA 8D 10001101 

00 00 00000000 
#15 15 00010101 


As can be seen, each machine code instruction is expressed as eight binary digits, called 
bits, which are collectively termed a byte. 
Usually each of the bits in a byte is numbered for convenience as follows: 


BE ers 
The number of the bit increases from right to left, but this is not so odd as it may first 
seem. 

Consider the decimal number 2934, we read this as two thousand, nine hundred and 
thirty four. The highest numerical value, two thousand, is on the left, whilst the lowest, 
four, is on the right. We can see from this that the position of the digit in the number is 
very important, as it will affect its weighr. 

The second row of Table 2.1 introduces a new numerical representation. Each base 
value is postfixed with a small number or power, which corresponds to its overall position 
in the number. Thus 10°, read as ten raised to the power of three, simply implies 
10 X 10 x 10 = 1000. 


Table 2.1 


ie [ee 
[Repesenaion | |e | | 






In binary representation, the weight of each bit is calculated by raising the base value, 
two, to the bit position (see Table 2.2). For example bit number 7 has a notational 
representation of 2’? which expands to: 2X 2X 2x2x*2x*2x2= 128! 


Table 2.2 


Weight 





BINARY TO DECIMAL CONVERSION 


As it is possible to calculate the weight of individual bits, it isa simple matter to convert 
binary numbers into decimal numbers. The rules for conversion are: 


If the bit is ser—that is it contains a 1—add its weight 
If the bit is clear—that is it contains a @—ignore its weight 


Let us try an example and convert the binary number 16101@1@ into its equivalent 
decimal value. 
1 X 128(2’) = 128 
@x 64(2°5)= 6 
1X 32(25)= 32 


@x 16(24)= @ 
1X 8&2)= 8 
@x 4(27)= @ 
1x 2A2')= 2 


@x 1(2%= @ 
170 


Therefore 19181010 binary is 17@ decimal. 


Similarly 11101110 represents: 
1 X 128(27) = 128 
1X 64(25)= 64 
1X 32(25)= 32 


@x 16(24)= @ 
1X 8(2)= 8 
1x 4(27)= 4 
1x 22')= 2 
@x 1(2%)= 86 
238 
in decimal. 


DECIMAL TO BINARY CONVERSION 


To convert a decimal number into a binary one, the procedure described earlier is 
reversed—each binary weight is subtracted in turn. If the subtraction is possible, a | is 
placed into the binary column and the remainder carried down to the next row where the 
next binary weight is subtracted. 

If the subtraction is not possible, a @ is placed in the binary column and the number 
moved down to the next row. For example, the decimal number 141 is converted into 
binary as in Table 2.3. 


Table 2.3 
Decimal Binary Binary Remainder 
number weight 

141 128(2’) | 13 

13 64(2°) 1) 13 

13 32(2°) 0 13 

13 16(2*) 4) 13 

13 8(2°) | 5 

5 4(2?) ] ] 

l 2(2') 0 | 

l 1(2°) l 0 





Therefore 141 = 10001101 binary. 


BINARY TO HEX CONVERSION 


Although binary notation is probably as close as we can come to representing the way 
numbers are stored within the Oric, you will no doubt have noticed that the machine code 
examples consist of a series of two characters preceded by a hash, ‘#’. This type 
of number is known as a Aexadecimal number, or hex for short, and its value is calculated 
to a base of 16! This, at first sight, may seem singularly awkward, however it does present 
several distinct advantages over binary and decimal numbers as we shall see. 


Sixteen different characters are required to represent all the possible digits in a hex 
number. To produce these, the numbers 6 to 9 are retained, and the letters A, B, C, D, E 


oe F are used to denote the values 1@ to 15. Binary conversion values are shown in Table 


Table 2.4 

Decimal Hex Binary 
@ i) 6000 

] | 000! 

2 2 0010 

3 3 6011 

4 4 0100 

5 5 61601 

6 6 0110 

7 7 O11! 

8 8 1080 

9 9 1001 

10 A 1010 
11 B 1011 
12 Cc 1180 
13 D 1101 
14 E 1110 
15 F 1111 


To convert a binary number into hex, the byte must be separated into two sets of four bits, 
termed nibbles, and the corresponding hex value of each nibble extracted from Table 2.4. 


Example Convert 8110 1001 to hex: 


High nibble Low nibble 


0110 001 


oh 


69 
Because it is not always apparent whether a number is hex or decimal (as in the example 
above), hex numbers in the Oric are always preceded by a hash—therefore 
01181681 is #69 (read hex six nine). 
By reversing the process, hex numbers can readily be converted into binary. 


Example Convert #AF to binary: 


je : 
Ps ue 


10161111 


1010 


It should now be apparent that hex numbers are much easier to convert to binary (and 
vice versa), than their decimal counterparts, and the maximum binary number possible 
with one byte, 11111111, requires just two hex digits, #FF. 


HEX TO DECIMAL CONVERSION 


For the sake of completeness, let's see how hex and decimal numbers may be converted. 
To transform a hex number into decimal, the decimal weight of each digit should be 
summed. 


Example convert #31A to decimal: 


The 3 has the value 3 X 167 = 3 X 16X16 = 768 
The | has the value 1 X 16' =1 X 16 = 16 
The A has the value | X 16° = 16 x 1 = 10 


add these together to give #31A = 794 decimal. 


Converting decimal to hex is a bit more involved and requires the number to be 
repeatedly divided by 16 until a value less than 16 is obtained. This hex value is noted, and 
the remainder carried forward for further division. This process is continued until the 
remainder itself is less than 16. 


Example convert 4072 to hex: 


4072 + 16+ 16=15=F (remainder = 4072 — (15 X 16 X 16) = 232) 
232+ 16=14=E (remainder = 232 — (14 X 16) = 8) 
8=8 


Therefore 4072 decimal is #FE8. 


Both of these conversions are a little long winded (to say the least!) and after all we do 
have a very sophisticated microcomputer available to us, so let’s make it do some of this 
more tedious work! 

To print the decimal value of a hex number, such as #31A enter: 


PRINT 431A 
and to print the hex value of a decimal number use: 
PRINT HEX$(4672) 


10 


3 Logically it Adds Up! 


BINARY ARITHMETIC 


Please don’t be put off and skip this chapter simply because it contains that dreaded 
word—arithmetic. The addition and subtraction of binary numbers is simple, in fact if 
you can count to two you will have no problems whatsoever! Although it is not vital to be 
able to add and subtract ones and noughts by ‘hand’, this chapter will introduce several 
new concepts which are important, and will help you in your understanding of the next 
few chapters. 


ADDITION 


There are just four, simple, straightforward rules when it comes to adding binary 
numbers. They are: 


1 6+60=80 
2, 1+60=1 
3. @+1=1 
4. 1+1=(1)0 


Note, that in rule 4, the result of 1 + 1 is (1). The | in brackets is called a carry bit, and 
its function is to denote an overflow from one column to another, remember, 1@ binary is 2 
decimal. The binary ‘carry’ bit is quite similar to the carry that can occur when adding two 
decimal numbers together whose result is greater than 9. For example, adding together 
9 + 1 we obtain a result of 10 (ten), this was obtained by placing a zero in the units column 
and carrying the ‘overflow’ across to the next column to give: 9 + 1 = 10. Similarly, in 
binary addition when the result is greater than |, we take the carry bit across to add to the 
next column. 

Let’s try to apply these principles to add together two 4 bit binary numbers, 0101 and 
0100. 


0101 (#5) 
+ 0160 (#4) 
1001 (#9) 


Reading each individual column from right to left: 


First column: 1+@ 
Second column: 0+ 86 
Third column: 1+ 1 
Fourth column: 6+6=60+(1) 


1 
6 
@ (1) 
l 


In this example a carry bit was generated in the third column, and was carried across and 
added to the fourth column. 


Adding 8 bit numbers is accomplished in a similar manner: 


01016101 (#55) 

+ 01110010 (#72) 

11000111 (#C7) 
SUBTRACTION 


So far we have been dealing with positive numbers, however in the subtraction of binary 
numbers we need to be able to represent negative numbers as well as positive ones. In 
binary subtraction though, a slightly different technique from normal everyday 
subtraction, is used, in fact we don’t really perform a subtraction at all—we add the 
negative value of the number to be subtracted. For example, instead of executing 4 — 3 
(four minus three) we actually execute 4 + (—3) (four, plus minus threc)! Figure 3.1 will 
hopefully eradicate any confusion or headaches that may be prevailing! 


Minus or negative direction Positive direction 
—___———_ ——_——_——_—_——> 





—3 -2 = i] 1 2 3 


a 


5 


Add 3 negative 


Figure 3.1 Diagramatic representation of 4 + (— 3). 


We can use the scale to perform the example 4 + (—3). The starting point is zero. First 
move to point 4 (i.e. four points in a positive direction) and add to this —3 (i.e. move three 
points in a negative direction). We are now positioned at point | which is, of course, where 
we should be. Try using this method to subtract 8 from 12, to get the principle clear in your 
mind. 

Okay, lets now see how we apply this to binary numbers, but first, just how are negative 
numbers represented in binary? Well, a system known as signed binary isemployed, where 
bit 7, known as the most significant bit (msb), is used to denote the sign of the number. 
Traditionally a ‘@’ in bit 7 denotes a positive number and a ‘!* a negative number. For 
instance, in signed binary: 


ae 
| Bits 6-6 give value = | 
Sign bit = 1, therefore number is negative 


so, 10000001 = —1. And: 


Qllii11 : 
| Bits @-6 give value = 127 


Sign = @ therefore number is positive 


therefore O1111111 = 127. 
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However, just adjusting the value of bit 7 as required, is not an accurate way of 
representing negative numbers. What we must do to convert a number into its negative 


counterpart, is to obtain its two's complement value. To do this simply invert each bit and 
then add one. 


To represent —3 in binary, first write the binary for 3: 
00006011 


Now invert each bit. (Replace cach @ with a 1, and each | with a @—this is known as its 
one’s complement. 


111111080 
Now add !: 


11111106 
+ ] 
11111101 
Thus, the two's complement value of —3 = 11111101. Let us now apply this to our original 
sum 4 + (—3): 
(4) 0090001690 
(—3) 11111101 
(Now add) (1000060801 
We can see that the result is 1 as we would expect, but we have also generated a carry bit 
due to an overflow from bit 7. This carry bit can be ignored for our purposes at present, 
though it does have a certain importance as we shall see later on. 
A further example may be of use. Perform 32 — 16 i.e. 32 + (—16). 
32 in binary is: 
00100000 
16 in binary is: 
000100090 . 


The two's complement of 16 is: 


11101111 
+ ] 
11110000 


Now add the two together: 


(32) 0010800090 
(—16) + 11110006 
(16) (1)00010000 


Ignoring the carry, we have our result, 16. 

We can see from these examples that, using the rules of binary addition, it is 
possible to add or subtract signed numbers. If the ‘carry’ is ignored, the result, including 
the sign, is correct. Thus it is also possible to add two negative values together and still 
obtain a correct negative result. Using two's complement signed binary let’s perform 
(—2) + (—2). 


2 in binary is: 


606000016 


The two's complement value is: 


P1}11101 
7 1 
11111110 





We can add this value twice to perform the addition: 
(—2) LIREETLO 


(—2) * UPL 
(I) 11111100 


Ignoring the carry, the final result is —4. You might like to confirm this by obtaining the 
two’s complement value of —4 in the usual manner. 


LOGICAL OPERATIONS 


The theory of logic is based on situations where there can only ever be two possibilities. 
namely yes and no. In binary terms these two possibilities are represented as | and @. 

There are three different logical operations that can be performed on binary numbers, 
they are AND, OR and EOR. In each case the logical operation is performed between the 
corresponding bits of two separate numbers. 


AND 


The four rules for AND are: 


l. @AND@=86 
2, |1AND®=80 
3. ®@ AND 1=8@ 
4. 1AND1=1 


As can clearly be seen, the AND operation will only generate a l if both ot the 
corresponding bits being tested are |. If a @ exists in either of the corresponding bits being 
tested, the resulting bit will always be @. 


Example AND the following two binary numbers: 


10106 
AND 69011 
00106 
In the result only bit I is set, the other bits are all clear because in each case one of the bits 
being tested contains a @. 


i ion i ‘ "ar 4 in bits. Imagine that 
The main use of the AND operation is to ‘mask’ or “preserve certain ; I 
we wish to preserve the low four bits of a byte (low nibble) and completely clear the high 


14 


four bits (high nibble). We would need to AND the number with 00001111. If the other 
byte contained 16161100 the result would be given by: 


10101106 (byte being tested) 
AND 6600861111 (mask) 
8000011690 


the high nibble is cleared and the low nibble preserved! 


OR 

The four rules for OR are: 
l1 @OR@=90 

2. 1OR@=1 

3. @ORI=1 

4. IORI=1 


Here the OR operation will result in a | if either or both the bits contain a 1. A@ will only 
occur if neither of the bits contains a 1]. 


Example OR the following two binary numbers: 


1018 
OR 68611 
1011 





Here, only bit 2 is clear, the other bits are all set as each pair of tested bits contains at 
least one 1. 


One common use of the OR operation is to ensure that a certain bit (or bits) is set—this 
is sometimes called ‘forcing bits’. As an example, if you wish to force bit @ and bit 7, you 
would need to OR the other byte with 10000001. 


00110110 (byte being tested) 
OR 10000001 (forcing byte) 
10110111 


The initial bits are preserved, but bit @ and bit 7 are ‘forced’ to |. 


EOR 


Like AND and OR, this donkey sounding operation has four rules: 


1. 9 EOR@=@ 
2. 1 EOR@=1 
3. @EORI=1 
4. 1EOR1=86 


This operation is exclusive to OR, in other words, if both bits being tested are similar a @ 
will result. A 1 will only be generated if the corresponding bits are unlike. 


Example EOR the following two binary numbers: 


10190 
EOR @011 
1001 
This instruction is often used to complement, or invert, a number. Do this by EORing the 
other byte with IIIIIII1. 
10061106606 (byte being inverted) 
Llidididdl (inverting byte) 


@1100111 





EOR 


Compare the result with the first byte, it is completely opposite. 
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4 the Registers 


To enable the 6502 to carry out its various operations, it contains within it several special 
locations, called registers. Because these registers are internal to the 6502, they do not 
appear as part of the Oric’s memory map (see Appendix 6), and are therefore referred to 
by name only. Figure 4.1 shows the typical programming model of the 6502. For the time 
being we need only concern ourselves with the first four of these six registers, they are the 
accumulator, the X and Y registers and the Program Counter. 


7 9 


Index registers 
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Figure 4.1 The registers—a typical programming model. 


THE ACCUMULATOR 


We have already mentioned the accumulator (or *A’ register) several times in the opening 
chapter. As you may have already gathered, the accumulator is the main register of the 
6502, and like most of the other registers it is eight bits wide. This means thatitcan holda 
single byte of information at any one time. Being the main register, it has the most 
instructions associated with it, and its principle feature is that all arithmetic and logical 
operations are carried out through it. 

The accumulator’s associated instructions are listed in Table 4.1. It is not absolutely 
vital to be familiar with these at present, but they are included now as an introduction. 


Table 4.1 





Accumulator instructions 





ADC Add with carry PHA Push accumulator 

AND Logical AND PLA Pull accumulator 

ASL Arithmetic shift left ROL Rotate left 

BIT Compare memory bits ROR Rotate right 

CMP Compare to accumulator SBC Subtract with carry 

EOR Logical EOR STA Store the accumulator 

LDA Load the accumulator TAX Transfer accumulator to X register 
LSR Logical shift right TAY Transfer accumulator to Y register 
ORA Logical OR TXA Transfer X register to accumulator 


TYA Transfer Y register to accumulator 





THE INDEX REGISTERS 


There are two further registers in the 6582 which can hold single byte data. These are the X 
register and the Y register. They are generally termed the ‘index registers’, because they are 
very often used to provide an ‘offset’ or index from a specified base address. They are 
provided with direct increment and decrement instructions—something the accumulator 
lacks—so are also quite often used as counters. However, it is not possible to perform 
arithmetic or logical operations in either index register, but there are instructions to 
transfer the contents of these registers into the accumulator and vice versa. 
The instructions associated with both registers are given in Table 4.2. 








Table 4.2 

X register instructions Y register instructions 

CPX Compare X register CPY Compare Y¥ register 

DEX Decrement X register DEY Decrement Y register 

INX Increment X register INY Increment Y register 

LDX Load the X register LDY Load the Y register 

STX = Store the X register STY Store the Y register 

TAX Transfer accumulator to X reg. TAY Transfer accumulator to Y reg. 


TXA_ Transfer X reg. to accumulator TYA_ Transfer Y reg. to accumulator 
TSX Transfer Status to X register 
TXS Transfer X register to Status 


THE PROGRAM COUNTER 


The Program Counter is the 6502's address book. It nearly always contains the address in 
memory where the next instruction to be executed sits. Unlike the other registers, itisa 16 
bit register, consisting physically of two 8 bit registers. These two are generally referred to 
as Program Counter High (PCH) and Program Counter Low (PCL). 
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5 A Poke at Machine Code 


Now that we have got some of the basics out of the way, why don’t we write our first 
machine code program—after all, that’s what this book is all about! 

As you are no doubt aware, REM statements can be used to give additional information 
to the user without affecting the program. In the following listings REM statements with 
two asterisks indicate subroutine or program titles, and REMs with one asterisk explain 
what the following machine code does. The assembly language instructions are included 
as REMs (without asterisks) alongside the machine code DATA statements. Enter the 
following—you can omit the REM statements if you like. 


Program 1 


18 REM * * MACHINE CODE DEMO * * 

20 REM * * PLACE ‘A* ON SCREEN * * 

38 CODE = #400 

49 FOR LOOP=8@TOS5 

58 READ BYTE 

68 POKE CODE + LOOP, BYTE 

76 NEXT LOOP 

80 

99 REM * * MACHINE CODE DATA * * 

95 REM * Load accumulator with code for ‘A’ * 
168 DATA #A9, #41 : REM LDA @ASC “A” 
105 REM * Store accumulator at location #BF5@ * 
118 DATA #8D, #50, #BF : REM STA #BFSO 
115 REM * Return from this subroutine to BASIC * 


120 DATA #60 : REM RTS 

136 

149 REM * * EXECUTE MACHINE CODE * * 
158 CLS 


169 CALL (CODE) 


The function of this short program is to place the letter ‘A’ on the screen. Nothing 
spectacular, but the program does incorporate various features that will be common to all 
your future machine code programs. The meaning of each line is as follows: 

18 


Line 30 Declare a variable called CODE to denote where the machine code is 


placed. 
Line 40 Set up a data-reading loop. 
Line 50 Read one byte of machine code data. 
Line 60 POKE byte value into memory. 
Line 76 Repcat loop until finished. 


Line 100 Machine code data. 

Line 110 Machine code data. 

Line 120 Machine code data. 

Line 150 Clear screen. 

Line 160 Execute the machine code. 


To see the effect of the program, just type in RUN, hit the RETURN key and voila—the 
A is there! 


Let’s try to answer two questions that come immediately to mind, namely: 


1. Where can machine code be stored? 
2. How can machine code be entered? 


CODE—THE PROGRAM COUNTER 


It should be fairly obvious that the machine code we write has to be stored somewhere in 
memory. In all the programs in this book I have used the BASIC variable ‘CODE’ as a 
pointer to the start address of the memory where the machine code is to be placed. (CODE 
acts, in effect, rather like the processor's own Program Counter). You may wish to use 
your own variable name—and this is perfectly acceptable. For example, you might 
consider that PC or even MACHINECODE are more appropriate names for the start of 
the code. It does not really matter. What matters is that you get into the habit of using the 
same variable name in all your programs, and thus avoid ambiguity. 

The value given to CODE must be chosen with care. It would be easy enough to 
allocate an area which causes the machine code to overwrite another program or even the 
assembly program itself! In Program 1 CODE is set to #40@ using the normal variable 
assignment statement: 


CODE = #400 

BASIC programs 0500 
- r #9420 
Machine code user area 29400 

1/O addresses 
#0300 

Run-time variables 
#0200 
#0160 
Zero page 

#0000 





Figure 5.1 The machine code user area 
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and the 6 bytes of machine code are stored here—or more correctly—in the 6 bytes 
Starting at #400 (#480 to #405). If you look at Figure 5.1 you will notice that this area has 
been reserved specifically for machine code programs. There are 32 bytes available here 
(#466 to #426) so, provided programs do not exceed this length, no problems should occur 
when using this area of memory. 

Quite often though machine code programs do exceed 32 bytes in length so an 
alternative storage area is required; there are two alternatives. 

Firstly, if you are only using TEXT mode then the area of memory normally reserved 
for the HIRES mode can be employed. A quick look at Figure 5.2 shows that the memory 
associated with HIRES mode extends from #9800 to 4B40@—a massive 7168 bytes or 
more simply 7K—and this should be more than ample for even the longest of machine 
code programs. However, using the GRAB command after placing your code in this area 
is perilous. 









#B800 
Standard character set 
+B400 
Place machine 
code here 
(in TEXT mode only) 
#9800 





BASIC programs 


Figure 5.2. Place machine code in HIRES area 


Perhaps the best and safest method is to lower the top of the user BASIC program area 
and place the machine code above it. This protects the machine code from being 
overwritten because normal BASIC programs cannot extend beyond the value assigned to 
the top of the user area, and it is also completely independent of the memory associated 
with both the HIRES and TEXT modes. 

The pseudo variable associated with the top of the user area is HIMEM-—short for high 
memory point. This variable may only be written to; it cannot be read directly. There are 
four bytes near the beginning of the Oric’s memory map (in what’s known as zero 
page—but more on that later), which seem to be associated with HIMEM. The two sets 
of bytes are: 


#A2 and 4A3 
#A6 and #A7 


but their exact relationship is not clear. 

Looking at Figure 5.3, we can see that the top of the user program area is located at 
#9860. All we need to do is to calculate how many bytes the machine code will require, add 
some more for safety and reset HIMEM. For instance, suppose we need about 509 bytes or 
so. Converting this to hex and subtracting it from #9800, we obtain a rounded figure of 
#9600. To reset HIMEM to this value enter: 


HIMEM #9600 


Note that no ‘=" sign is needed—just a space. Once set, only GRAB will alter its 
value—executing NEW or even performing a reset will not affect it. 


#B400 
User programs if 
GRAB used 
Power-on HIMEM #9800 
Place machine code here 
Reset HIMEM —_—-- #9600 


User programs 





Figure 5.3 Place machine code above HIMEM 


Using the space above HIMEM has the added advantage that it frees the machine code 
area. This can then be used by your machine code programs as a data and address storage 
area. 

To summarize then, the following areas can be considered reasonably ‘safe’ for machine 
code: 


1. User machine code area (#400 to #420). 
2. Memory normally reserved for HIRES mode (#9808 to #B408). 
3. Above the reset value of HIMEM. 


ENTERING MACHINE CODE 


Program | (page 18) demonstrates the most obvious method of entering a machine code 
program. The hex is placed in a series of data statements which are subsequently READ 
from within a FOR... NEXT loop and POKEd into memory using the loop counter 
(LOOP) as an offset from the machine code base address (given by CODE). This ensures 
that the bytes are placed in consecutive memory locations. 

Notice also in Program 1, and for that matter in all the programs in this book, each 
machine code instruction is placed ina separate DATA statement and followed by a REM 
statement which depicts mnemonically the operation of that particular opcode. For 
example: 


100 DATA #A9, #41: REM LDA @ASC*A” 


It is a good idea to get into the habit of doing this simply because it adds to the 
program’s readability. This is particularly important if you come back to the program 
several weeks after writing it, when you will almost certainly have forgotten what you 
originally wrote. Being faced with a DATA line containing nothing but hex numbers will 
do nothing to jog your memory: 


123 DATA #A9, #70, #85, #22, #8D, #50, #90, #60 


if you see what I mean! 
One final point regarding the loop count. When entering this, count the total number of 
hex bytes and subtract one. (Remember that the loop counter itself should start from ‘@’ to 
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ensure that the very first byte is placed at the address spccified E— 
CODE + LOOP = 1400 +0 = 4400.) f Me 

Although the above method of entering machine code is probably the best, it is 
somewhat long-winded. An easier way involves the use of a machine code monitor 
program. This allows machine code to be entered into memory by typing in hex numbers 
In response to certain prompts. A simple, though adequate example of such a monitor is 
given in Program 2. 


Program 2 


18 REM * * ORIC MACHINE CODE MONITOR * * 
28 CLS 

3@ INK 3: PAPER 4 

49 PRINT “ORIC MONITOR”: PRINT 

5@ INPUT “Enter Assembly Address :”; AS 

68 ADDR = VAL(AS) 


76 REPEAT 
86 PRINT HEXS(ADDR); “* : #”’; 
908 GET BS$ 


160 IF BS = “S** GOTO 250: REM * STOP * 
116 IF ASC(B$) > ASC(‘“F”) GOTO 98 
120 BS = “#" + BS: HIGH = VAL(BS) 
138 IF HIGH > 15 GOTO 98 

140 IF HIGH < @ GOTO 98 

150 PRINT RIGHTS(B8, 1); 

160 GET C$ 

170 IF ASC(C$) > ASC(“*F”") GOTO 168 
188 CS = “#"" + C$: LOW = VAL(CS) 
196 IF LOW > 15 GOTO 1608 

200 IF LOW < @ GOTO 168 

210 PRINT RIGHTS(CS, 1) 

220 BYTE = HIGH * 16 + LOW 

230 POKE ADDR, BYTE 

240 ADDR = ADDR + 1 


250 UNTIL BS = “S” 


Enter and RUN the program. After it displays the heading you are asked to enter the 
‘assembly address’. This is the address from which you wish the machine code to be stored, 
and is the value you would normally have assigned to CODE. The address can be entered 
as a decimal number, or as a hex value if preceded by a ‘#’. On hitting RETURN the first 
address is displayed in hex notation and is followed by a further ‘#’. All you now have to 
do is to type in the hex digits (minus the hash which is already there!). After you type the 
second digit of the byte, it is POKEd into the appropriate memory location and the next 
address is displayed. 

To leave the monitor program just type ‘S’ (for Stop!) when the next address is 
displayed. The program checks for (and rejects) illegal hex values. A typical RUN from the 
monitor program is shown in Figure 5.4. 
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ORIC MONITOR 


Enter Assembly Address : ?#400 
#400 : HAY 

#401 : #41 

#402 : #8D 

#403 : #50 

#404 : #BF 

#405 : #60 

#406 : AS 


Ready 





Figure 5.4 A typical monitor run. 


CALLING MACHINE CODE 


To execute a machine code program the BASIC statement CALL is used. To tell the 
BASIC interpreter just where the machine code is located, the CALL statement must be 


followed by a label or address. So, to execute the machine code generated by the assembly 
program type in cither: 


CALL(CODE) 
which is the label name which marks the start of the assembly program, or: 
CALL(#400) 


which is the start address of the machine code itself. 


GETTING IT TAPED 


It is a very good idea, as a matter of routine, to get into the habit of saving your machine 
code programs on tape BEFORE you actually RUN them. This may seem a bit back to 
front because you normally would not do this in BASIC until you had RUN, tested and 
debugged the program. The trouble with running a machine code program for the first 
time, though, is that if it does contain any bugs, it will almost certainly cause the Oric to 
‘hang-up’ and the only way out of this is to switch it off (and then back on again) at the 
mains, and start again. RESET has no effect whatsoever. If your machine code does failin 
this way, and you've saved it on tape, all you have to do isto CLOAD it back in again and 
swat the bug out! 

Full details of loading and saving programs and blocks of memory on to tape are 
described in Chapter 11 of the Manual. 
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6 Status Symbols 


THE STATUS REGISTER 


The Status register is unlike the various ‘other’ registers of the 6562. When using it, we are 
not really concerned with the actual hex value it contains, but more with condition or state 
of its individual bits. These individual bits are used to denote or flag certain conditions as 
and when they occur during the course of a program. Of the register’s eight bits, only seven 
are in use—the remaining bit (bit 5) is permanently set. (In other words it always contains 


al.) 
Figure 6.1 shows the position of the various flags, each of which is now described in 


detail. 


7 9 
Nv] {Blo} if zic) 


Carry = 1 if carry occurred. 
Zero=1 if result zero. 

IRQ =1 If interrupt disabled. 
Decimal = 1 if using BCD. 
Break=1 if BREAK occured. 

Not used=1 always. 

Overtiow = 1 if overflow occurred. 
Negative = 1 If result negative. 


Figure 6.1 Status register flags. 
Bit 7: The Negative flag (N) 


In signed binary, the Negative flag is used to determine the sign of a number. If the flag is 
set (N = 1) the result is negative. If the flag is clear (N = 6) the result is positive. 
However a whole host of other instructions condition this particular flag, including all 
the arithmetic and logical instructions. In general, the most significant bit of the result of 
an operation is copied directly into the N flag. 
Consider the following two operations: 


LDA @#86 \ load accumulator with #80 
This will set the Negative flag (N = 1) because 480 = 16000000 in binary. Alternatively: 


LDA @#7F \ load accumulator with #7F 
will clear the Negative flag (N = @) because 47F = 61111111 in binary. There are two 
instructions which act on the state of the N flag—these are: 

BMI Branch on minus (N = 1) 

BPL Branch on plus (N = @) 


More on these later. 
Bit 6: The Overflow flag (V) 


This flag is probably the least used of all the Status register flags. It is used to indicate if a 
carry occurred from bit 6 during an addition, or if a borrow occurred to bit 6 ina 
subtraction. If either of these events took place the flag is set (V = 1). 

Look at the following two examples: 
First, #09 + #07: 


(#09) 00001001 
(#07) +80000111 
(#10) 00010000 


| en <7 overflow from bit 6 therefore V = 0. 
Second, #7F + 4@1: 


(H7F) OVATILE 
(#01) +00000061 
(#80) 10000000 


t __ Overflow has occurred from bit 6 therefore V = 1. 


If we were using signed binary this addition would give a result of —128, which is of 
course incorrect. However this fact is flagged and so the result can be corrected as 
required. 

Bit 5 
This bit is not used and is permanently set. 


Bit 4: The Break flag (B) 


This flag is set whenever a BREAK occurs, otherwise it will remain clear. This may seema 
bit odd at first, because surely we will know when a BREAK occurs. However, it is 
possible to generate a BREAK externally by something called an Interrupt, and this flag is 
used to help distinguish between these ‘BREAKs"’. 


Bit 3: The Decimal flag (D) 

This flag tells the processor just what type of arithmetic is being used. If it is cleared (by 
CLD), as is usual, then normal hexadecimal operation occurs. If set (by SED) all values 
will be interpreted as Binary Coded Decimal. 

Bit 2: The Interrupt flag (I) 

We mentioned interrupts above in the description of the Break flag. Suffice to say now, 


that the flag is set (I = 1) when the IRQ interrupt is disabled, and is clear (I =0) when IRQ 
interrupts are permitted. 
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Bit 1: The Zero flag (Z) 


As its name implies, the flag is used to show whether or not the result of an operation is 
zero. If the result is zero the flag is set (Z= 1), otherwise it is cleared (Z = @). It is true to say 
that the Zero flag is conditioned by the same instructions as the Negative flag. Executing: 


LDA @@ \ load accumulator with zero 
will set the Zero flag (Z = 1) but: 

LDX @#FA \ load X register with #FA 
will clear the Zero flag (Z = 8). 


Bit 0: The Carry flag (C) 


We have already seen that adding two bytes together can result in carries occurring from 
one bit to another. What happens if the carry is generated by the most significant bits of an 
addition? 

For example, when adding #FF + #80: 


(#FF) LEED thi 
(#86) +100600000 
(#7F) (IO1LTITI11 


Carry over from bits 7 


the result is just too large for eight bits, an extra ninth bit is required. The Carry flag acts as 
this ninth bit. 

If the Carry flag is clear at the start of an addition (C =0)and set on completion (C= 1) 
the result is greater than 255. It follows that if the flag is set (C = 1) before a subtraction 
and clear on completion (C = @), the value being subtracted was larger than the original 
value. Two instructions are available for direct use on the Carry flag: 

CLC Clear Carry flag (C = 8) 


SEC Set Carry flag (C = 1) 
Two instructions are also provided to act on the condition of the Carry flag. 


BCC Branch on Carry clear (C = @) 
BCS Branch on Carry set (C = !) 


/ Addressing Modes I 


The 6562 has quite a small instruction set when compared with some of its fellow 
microprocessors—in fact it has a basic clique of just 56 instructions. However, many of 
these can be used ina variety of ways, which effectively increases the range of operations 
to 152. The way in which these instructions are interpreted is determined by the addressing 
mode used, some examples of which are given here: 


Addressing mode Mnemonic example Opcode Operand(s) 
Immediate LDA @#FF A9 FF 
Zero page LDA #76 AS 70 
Zero page indexed LDA #780, X BS 70 
Absolute LDA #1580 AD 60 15 
Indirect pre-indexed LDA (#70, X) Al 70 
Indirect post-indexed LDA (#76), X Bl 70 


Absolute indexed LDA #1580, X BD 80 15 


All seven of these instructions load the accumulator—but in each case the data loaded is 
obtained from a different source as defined by the opcode. This, as you may have noticed, 
is different in each case. 

For the time being we shall only look at the first two of these addressing modes, 
immediate and zero page, both of which we have used several times already. 


ZERO PAGE ADDRESSING 


Zero page addressing is used to specify addresses in the first 256 bytes of RAM where data 
which has to be loaded into a specified register could be located. Because the high byte of 
the address will always be #0@ it is omitted, and therefore the instruction and address 
require just two bytes of memory. 


Operation: DATA HAS, #70 


LDA #70 


accumulator 
#71 
470 
#6F 
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In the above example, LDA #79, the contents of location #70 (in this case HAB) are loaded 
into the accumulator. 


The use of zero page needs some care as this area is used as a Scratchpad by the BASIC 
interpreter for storing addresses and performing calculations. No problems should occur 
if your program is written exclusively in machine code. However, particular care is needed 
if your program is written in a hybrid of BASIC and machine code, because it is quite 
possible that your machine code could corrupt zero page data being held by the interpreter 
(FOR ... NEXT loop counters for instance). Unfortunately Oric have not made any 
documentation available on this sensitive area of memory, so if possible, use the user area 
between 4400 and #420 as a data storage area. If you must use zero page, then test your 
machine code fully to ensure it does not corrupt the calling BASIC. (If it does, then 
reCLOAD it, and try using alternative locations.) 
The instructions associated with zero page addressing are shown in Table 7.1. 


Table 7.1 

Zero page addressing instructions 
ADC Add with carry LDX Load X register 
AND Logical AND LDY Load Y register 
ASL Arithmetic shift left LSR Logical shift right 
BIT Bit test ORA Logical OR 
CMP Compare accumulator ROL Rotate left 
CPX Compare X register ROR Rotate right 
Cry Compare Y register SBC Subtract with carry 
DEC Decrement memory STA Store accumulator 
EOR Logical EOR STX Store X register 
INC Increment memory STY Store Y register 
LDA Load accumulator 


IMMEDIATE ADDRESSING 


This form of addressing is used to load the accumulator, or the index registers, with a 
specific value which is known at the time of writing the program. The 6502 will know from 
the opcode that the byte following is in actual fact data and not an address. However, to 
remind us of the fact, and to assist us when we are writing the initial assembler, we can 
precede the data byte with a ‘@" sign (this shares the ‘2’ key on the Oric keyboard). Only 
single byte values can be specified because the register size is limited to just eight bits. 

If we wish our machine code program to load the accumulator with 255, we can include 
the following two-byte sequence in our program: 


DATA #A9, #FF: REM LDA @HFF 


where #A9 is the ‘load the accumulator immediate’ code. 
Similarly, the X and Y registers can be loaded immediately with: 


DATA #A2, #41 : REM LDX @“A” 
DATA #A6, HFA : REM LDY @#FA 


where A2 and A@ are the immediate codes for loading the X and Y registers. 


Operation: 


LDA 1255 
Accumulator 


Program 3 uses both zero page and immediate addressing to place an exclamation mark 
on the screen. 


Program 3 


10 
20 
30 
40 
50 
60 
70 
80 
81 
82 
83 
84 
85 
90 
160 
110 
120 
130 
140 
150 
160 
170 


REM * * ZERO PAGE ADDR. * * 
CODE = #400 

FOR LOOP = 6 TO 9 

READ BYTE 

POKE CODE + LOOP, BYTE 
NEXT LOOP 


REM * * M/C DATA * * 

REM * Load X with ASCII code for X * 

REM * Store code in location #22 * 

REM * Load accumulator with contents of #22 * 


REM * Store accumulator in screen memory * 
REM * Return back to BASIC * 


DATA #A2, #21 : REM LDX @"*!” 
DATA #86, #22 : REM STX #22 
DATA #AS, #22 : REM LDA #22 
DATA 48D, #AA, #BB : REM STA SCREEN 
DATA #60 : REM RTS 


REM * * SET UP & EXECUTE * * 
CLS 
CALL (CODE) 
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8 Bitsand Bytes 


LOAD, STORE AND TRANSFER 


To enable memory and register contents to be altered and manipulated, three sets of 
instructions are provided. 


Load instructions 


The process of placing memory contents into a register is known as /oading, some 
examples of which we have already seen. To recap however, these are the three load 
instructions: 

LDA Load accumulator 

LDX Load X register 

LDY Load Y register 

All of these instructions may be used with immediate addressing, but when dealing with 

memory locations, it is more correct to say that the contents of the specified address are 
copied into the particular register, as the source location is not altered in any way. 


For example, with LDA #70, the contents of location #7@ (in this case FA) are copied 
into the accumulator, location #79 is not altered: 


#70 Accumulator 


The Negative and Zero flags of the Status register are conditioned by the load 
operation. 


Store instructions 


The reverse process of placing a register’s contents into a memory location, is known as 
storing. There are three store instructions: 


STA Store accumulator 
STX Store X register 
STY Store Y register 


The register value is unaltered and no flags are conditioned. 


Example: 


LDA @k@ 
STA #420 


Accumulator #420 


Transfer instructions 


Instructions are provided to allow the contents of one register to be copied into 
another—this is known as transferring. The Negative and Zero flags are conditioned 
according to the data being transferred. There are four instructions controlling transfers 
between the index registers and the accumulator. 


TXA Transfer X register to accumulator 

TAX Transfer accumulator to X register 

TYA Transfer Y register to accumulator 

TAY Transfer accumulator to Y register 
Example: 

LDA @#FF 

TAY 

TAX 

Y register 







Accumulator 


X register 


Unfortunately, you cannot transfer directly between the X and Y registers, you have to 
use the accumulator as an intermediate store. 


YTOX TYA \. Y into accumulator 
TAX \ accumulator into X 

Similarly: 
XTOY TXA \ X into accumulator 
TAY \ accumulator into Y 


This form of single byte operation is known as implied addressing because the 
information is contained within the instruction itself. 


31 


32 





Y 
register 


Figure 8.1 Load, store and transfer instruction flow. 


PAGING MEMORY 


We have seen that the Program Counter consists of two cight bit registers, giving a total of 
16 bits. If all these bits are set, 11111111 11111111, the value obtained is 65536, or 4FFFF. 
Therefore the maximum addressing range of the 6502 is #6000 through to 4FFFF. This 
range of addresses is implemented as a series of pages and the page number is given by the 
contents of PCH. It follows that PCL holds the address of the location on that particular 
page. 

As Figure 8.2 illustrates, each page of memory can be likened to a page of a book. This 
book has 256 pages labelled in hex format from #00 to #FF. Each individual page is 
ruled into 256 lines which in turn are labelled (from top to bottom) #0@ to #FF. 

Thus the address 4FFFF refers to line 4FF on page #FF, the very last location in the 
Oric’s memory map! Unlike conventional books, memory begins with page #00 which is 
more affectionately known as zero page. Owing to the 6502's design zero page is very 
important, as we shall see when we take a further look at addressing modes in 
Chapter 10. 

Although we have referred to the Oric’s memory map as a series of pages, it is more 
frequently talked of in terms of ‘K’. For example, Orics are supplied with either 16K or 
48K of memory. The term ‘K’ is short for kilo, but unlike its metric counterpart, one 
kilo of memory, or a kilobyte, consists of 1924 bytes and not 1000 bytes. This slightly 
higher value is chosen because it is divisible by 256 and corresponds to exactly four 
pages of memory (4 X 256 = 1624). The total memory map therefore encompasses 64K 
as the following kilobyte calculator (written in BASIC!) will confirm. 


Page #FF 























Page #61 
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BR 
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ee 
= ee 
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et 
Figure 8.2 Pages of the Oric’s memory. 


Program 4 
18 REM * * KCALC * * 
20 CLS 
30 REPEAT 
40 INPUT “K value:”; K 
5@ BYTES = 1024*K 
68 PRINT “K value is’; BYTES; ‘*Decimal”’; 
70 PRINT HEXS(BYTES); ‘Hex’ 
8@ UNTIL @ | 
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9 Arithmetic in Machine Code 


We can now put some of the basic principles we have encountered in the opening chapters 
tO some more serious use—the addition and subtraction of numbers. These two 
procedures are fundamental to machine code and will generally find their way into 
most programs. 


ADDITION 


Two instructions facilitate addition, they are: 


CLC Clear Carry flag 

ADC Add with carry 
The first of these instructions, CLC, simply clears the Carry flag (C = @). This will 
generally be performed at the very onset of addition, because the actual addition 
instruction, ADC, produces the sum of the accumulator, the memory byte referenced and 


the Carry flag. The reason for doing this will become clearer after we have looked at some 
simple addition programs. Enter Program 5. 


Program 5 


18 REM * * SIMPLE ADD * * 

20 CODE = #400 

30 FOR LOOP =@TO7 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 
60 NEXT LOOP 


70 

80 REM * * M/C DATA * * 

90 

100 DATA #18 : REM CLC 

118 DATA #A9, #07 ': REM LDA @47 
120 DATA #69, #03 : REM ADC @#3 
130 DATA #85, #70 : REM STA #70 
149 DATA #60 : REM RTS 


150 

166 CALL (CODE) 

170 PRINT “RESULT IS :"; 
18@ PRINT PEEK (#70) 


As can be seen in line 119, this program loads 7 into the accumulator using immediate 
addressing. Immediate addressing is used again in line 120 to add 3 to the accumulator 
value. The result, which is in the accumulator, is then stored at #70. Line 160 executes the 
assembled machine code, and the result (if you're quick with your fingers you'll know 
it’s 10!), is printed out. RUN the program to sec its effect, and try substituting your own 
values in lines 110 and 120. 


Re-type line 160 thus: 
1066 DATA #38 : REM SEC 


This instruction will set the Carry flag when the program is next executed. Reset lines 110 
and 120 (if you have altered them),and RUN the program again. The result is now 11. The 
reason being that the Carry flag’s value is taken into consideration during ADC (add 
with carry) and this time its value is 1. 


Accumulator + memory + _ carry = _ result 
CLC 7 + 3 + 0 = 10 
SEC 7 + 3 + | = 11 


Again you might like to try your own immediate values—you'll find the result is always 
one greater than expected. 

This program is quite wasteful both in terms of memory used and time taken for 
execution. If we know the values to be added together beforehand, then it is more efficient 
to add them together first. The machine code part of the program can then be 
incorporated into just two lines: 

DATA #A9, #0A : REM LDA @10 


DATA 485, #22 : REM STA #22 
Program 6 is a general purpose single byte addition program. 
Program 6 


10 REM * * GENERAL PURPOSE SINGLE BYTE ADD * * 
26 CODE = 4400 

30 FOR LOOP =@TO7 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 

60 NEXT LOOP 


70 

80 REM * * M/C DATA * * 

90 ‘ij 

100 DATA #18 : REMCLC 

118 DATA #AS, #70 : REM LDA #70 
120 DATA #65, #71 : REM ADC #71 
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138 DATA #85, #72 : REM STA #72 
140 DATA #60 : REM RTS 
150 
168 REM * * SET UP & EXECUTE * * 
176 CLS 
188 INPUT “FIRST NUMBER”;NUMI1 
199 POKE #76, NUM1 
208 INPUT “SECOND NUMBER”;NUM2 
216 POKE #71, NUM2 
226 CALL (CODE) 
230 PRINT “RESULT IS :”; 
246 PRINT PEEK (#73) 
RUN the program a few times entering low numerical values in response to the 
program's prompts. 


Now enter 128 and 128, as your inputs. The result is 8, why? The reason is that the 
answer, 256, is too big to be held in a single byte: 


128 #80 1080800008 
+ 128 + #80 + 100600000 
256 #100 (100000060 


and as can be seen, a carry has been produced by the bit overflow from adding the two 
most significant bits. As the Carry flag was initially cleared before the addition, it will now 
be set, signalling the fact that the result is too large for a single byte. 

This principle is used when summing multibyte numbers, and is illustrated by Program 
7, which adds two double byte numbers. 


Program 7 


16 REM * * DOUBLE BYTE ADD * * 
20 CODE = #400 

30 FOR LOOP = @ TO 13 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 

68 NEXT LOOP 


78 

80 REM * * M/C DATA * * 

90 

100 DATA #18 >: REM CLC 

116 DATA #AS, #78 : REM LDA #70 
114 DATA #65, #72 >: REM ADC 472 
11S DATA #85, #74 : REM STA 474 
121 DATA #AS, #71 : REM LDA #71 
122 DATA #65, #73 : REM ADC #73 
138 DATA #85, #75 : REM STA #75 


148 DATA #60 : REM RTS 

150 

168 REM * * SET UP & EXECUTE * * 

176 CLS 

186 INPUT “FIRST NUMBER”;NUMI1 

196 DOKE #76, NUM1 

260 INPUT “SECOND NUMBER”;NUM2 

210 DOKE #72, NUM2 

226 CALL (CODE) 

230 PRINT “RESULT IS :”; 

240 PRINT DEEK (#74) 

This routine will produce correct results for any two numbers whose sum is less than 

65536 (HFFFF) which is the highest numerical value that can be held in two bytes of 
ose the Carry flag is cleared at the onset of the machine code itself. If any carry 


should occur when adding the two low bytes together, it will be transferred over to the 
addition of the two high bytes. 


SUBTRACTION 


The two associated instructions are: 


SEC Set Carry flag 
SBC Subtract, borrowing carry 
The operation of subtracting one number from another (or finding their difference) is 
the reverse of that used in the preceding addition examples. Firstly the Carry flag is set 
(C = 1) with SEC, and then the specified value is subtracted from the accumulator using 


SBC. The result of the subtraction is returned in the accumulator. 
The following program performs a single byte subtraction: 


Program 8 


10 REM * * SINGLE BYTE SUBTRACTION * * 
20 CODE = #400 

30 FOR LOOP = 6 TO7 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 

68 NEXT LOOP 


70 

86 REM * * M/C DATA * * 

90 

100 DATA #38 : REM SEC 

118 DATA #AS, #70 : REM LDA #76 
120 DATA #E5, 471 : REM SBC 471 

138 DATA #85, #72 : REM STA 472 
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140 DATA #60 

150 

168 REM * * SET UP & EXECUTE * * 
1708 CLS 

188 INPUT “FIRST NUMBER “;NUMI 
198 POKE #70, NUM! 

208 INPUT “SECOND NUMBER ";NUM2 
210 POKE #71, NUM2 

226 CALL (CODE) 

230 PRINT “RESULT IS :”; 

240 PRINT PEEK (#73) 


REM RTS 


RUN the program and input your own values to sce the results. 

You may well be wondering why the Carry flag is set before a subtraction rather than 
cleared. Referring back to Chapter 3, you will recall that the subtraction there was 
performed by adding the two's complement value. This is found by first inverting all the 
bits to obtain the one’s complement, and then adding |. The 6502 obtained the | to be 
added to the one’s complement form, trom the Carry flag. Thus we can say: 


1. If the Carry flag is set after SBC, the result is positive or zero. 
2. If the Carry flag is clear after SBC, the result is negative and a borrow has occurred. 


Try changing line 186 to CLC and re-RUN the program. Now your results are one less 
than expected—the reason being that the two's complement was never obtained by the 
6502, because only a ‘@’ was available in the Carry flag to be added to the one’s 
complement value. 

To subtract double byte numbers, the Carry flag is set at the entry to the routine, and the 
relative bytes are subtracted and stored. The resulting program will look something like 
this: 


Program 9 


18 REM * * DOUBLE BYTE SUBTRACTION * * 
20 CODE = #480 

3@ FOR LOOP = @ TO 13 

40 READ BYTE 

58 POKE CODE + LOOP, BYTE 

68 NEXT LOOP 


70 

88 REM * * M/C DATA * * 

98 

100 DATA #38 REM SEC 

116 DATA #AS, #70 REM LDA #76 
120 DATA #ES5S, #72 REM SBC #72 
136 DATA #85, #74 REM STA #74 
149 DATA #AS, #71 REM LDA #71 
156 DATA #ES, #73 REM SBC #73 
166 DATA #85, #75 REM STA 475 


170 
180 
198 
200 
210 
220 
230 
240 
250 
260 
270 


DATA #60 : REM RTS 


REM * * SET UP & EXECUTE * * 
CLS 

INPUT “FIRST NUMBER ":NUMI1 
DOKE #70, NUMI 

INPUT “SECOND NUMBER";NUM2 
DOKE #72, NUM2 

CALL (CODE) 

PRINT “RESULT IS :”: 

PRINT DEEK (#74) 


NEGATION 


The SBC instruction can be used to convert a number into its two's complement form. 
This is done by subtracting the number to be converted, from zero. The following 
program asks for a decimal value (less than 255) and prints its two’s complement value in 


hex: 


Program 10 


10 
20 
30 
40 
58 
60 
78 
80 
90 
100 
180 
120 
130 
140 
156 
168 
170 
180 
198 
200 
210 
220 


REM * * 2’s COMPLEMENT CONVERTER * * 
CODE = #400 
FOR LOOP = @ TO 7 
READ BYTE 
POKE CODE + LOOP, BYTE 
NEXT LOOP 


REM * * M/C DATA * * 


DATA #38 : REM SEC 
DATA #A9, #00 : REM LDA @0 
DATA 4E5, #70 : REM SBC #70 
DATA 485, #71 : REM STA #71 
DATA 460 : REM RTS 


REM * * SET UP & EXECUTE * * 


INPUT ‘tNumber to Convert :”;NUM 
POKE #70, NUM 
CALL (CODE) 
PRINT ‘2's Complement value is :”’; 
PRINT PEEK (#71) 
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10 Addressing Modes Il 


Let us now take a second look at addressing modes. In the previous chapters we have seen 
how data can be obtained directly by an instruction using immediate addressing, or 
indirectly from a location in zero page using zero page addressing. We shall now see how 
two byte address locations can be accessed both directly and indirectly (through the all 
important zero page), and how whole blocks of memory can be manipulated using indexed 
addressing. 


ABSOLUTE ADDRESSING 


Absolute addressing works in exactly the same manner as zero page addressing, but it 
covers all memory locations outside zero page. The opcode is followed by two bytes 
which specify the address of the memory location (which can be anywhere in the range 
#100 to #FFFF). 


Operation 
a Co ce 
#421 
#420 
#41F 





As can be seen above, the operation code is followed by the address which, as always, is 
stored in reverse order low byte first. The contents of location #426 are copied into the 
accumulator when the instruction is executed. Absolute addressing was used in line 120 of 
Program 3 (page 29) to store the accumulator’s contents into screen memory, effectively 
displaying the exclamation mark. 

The complete list of instructions associated with absolute addressing is shown in Table 
10.1. 


Table 10.1 





Absolute addressing instructions 





ADC Add with carry LDA Load accumulator 
AND Logical AND LDX Load X register 
ASL Arithmetic shift left LDY Load Y register 
BIT Bit test LSR Logical shift right 
CMP Compare accumulator ORA Logical OR 

CPX Compare X register ROL Rotate left 

CPY Compare Y register ROR Rotate right 

DEC Decrement memory SBC Subtract with carry 
EOR Logical EOR STA Store accumulator 
INC Increment memory STX Store X register 
JMP Jump STY Store Y register 
JSR Jump, save return 





ZERO PAGE INDEXED ADDRESSING 


In zero page indexed addresing, the actual address of the operand is calculated by adding 
the contents of either the X or Y register to the zero page address stated. 


Operation: 


LDA #70,X as) ae | Accumulator 
= : fief) 
X register 


The X register in this instance contains 407. This is added to the specified address, #70, 
to give the actual address, #77. The contents of location #77 (in this case FA) are then 
loaded into the accumulator. Similarly: 


STX #72,Y | 96 | 72. | #76 #76 
04 | 





Y register 





X register 


Here the Y register is used as an index to allow the contents of the X register to be stored in 
memory location #76. This address was obtained by adding the Y register’s value, #04, to 
the specified value, #72. The original contents of location #76 (@A) are overwritten. The 
instructions associated with zero page indexing are listed in Table 10.2. 
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Table 10.2 





Zero page indexed addressing instructions 





ADC Add with carry LDY Load Y register 
AND Logical AND LSR Logical shift right 
ASL Arithmetic shift left ORA Logical OR 

CMP Compare ROL Rotate left 

DEC Decrement memory ROR Rotate right 

EOR Logical EOR SBC Subtract with carry 
INC Increment memory STA Store accumulator 
LDA Load accumulator *STX Store X register 
*LDX Load X register STY Store Y register 





The * indicates the only commands which can use the Y register as an index. All other 
commands are for X register only. 


ABSOLUTE INDEXED ADDRESSING 


Absolute indexed addressing is like zero page indexed addressing except that the locations 
accessed are outside zero page. The X and Y registers may be used as required to operate 
with the accumulator, or each other. 


Operation: 
LDA #9200,Y #92FA Accumulator 
Y register 





The Y register's contents (HFA) are added to the two byte address (#9200) to give 
effective address (H92FA). 


The following program demonstrates how absolute indexed addressing can be used to 
move a section of memory from one location to another. 


Program 11 


18 REM * * ABSOLUTE INDEXED ADDRESSING * * 
2@ REM * * RESET ‘HIMEM 49600" * * 
3@ CODE = #9600 
49 FOR LOOP =@TO 16 
58 READ BYTE 
60 POKE CODE + LOOP, BYTE 
78 NEXT LOOP 
80 
96 REM * * M/C DATA * * 
1060 


116 DATA #A2, #00 : REM LDX @@ 


126 DATA #AQ, #26 : REM LDY @#20 

136 DATA #BD, #AA, 4#BB : REM LDA #BBAA, X 
146 DATA #609, #20 : REM ORA @420 

150 DATA #9D, #EA, #BC : REM STA HBCEA, X 
160 DATA #E8 : REM INX 

170 DATA #88 : REM DEY 

186 DATA #DO, #F4 : REM BNE -12 

190 DATA #60 : REM RTS 

200 

210 REM * * SET UP & EXECUTE * * 

220 CLS 


230 PRINT “ABSOLUTE INDEXED ADDRESSING” 
240 GET A$: REM Press a key 
250 CALL (CODE) 


When RUN, the message of line 23@ is printed on to the TEXT mode display. The 
program then waits for a key to be pressed before calling CODE. The X register acts as 
the offset counter and the Y register as the loop counter—lines 110 and 129 initialize 
them. The byte at ‘the top of the screen + X’ is then loaded into the accumulator using 
absolute indexed addressing (line 130). It is then converted into a lower case ASCII 
character by logically ORing its present ASCII value with #20. This forces bit 5 to one 
(which is the binary difference between upper case and lower case ASCII characters). For 
example: 


ASC “A" = #41 01000001 
ASC “a" = #61 611060001 


Line 15@ stores this new value into the lower half of screen memory using absolute indexed 
addressing. The X register is incremented (line 160) to point to the next location to be 
moved; the Y register is decremented (line 170), and if not at zero, the program loops back 
to line 13@ for the next byte. When the Y register reaches zero the machine code returns 
control to BASIC (line 19@). 

The instructions associated with absolute indexed addressing are shown in Table 10.3. 





Table 10.3 
a ea a ee 
Absolute indexed addressing instructions 
*ADC Add with carry **LDX Load X register 
*AND Logical AND Load Y register 
ASL Arithmetic shift left LSR Logical shift right 
*“CMP Compare memory *ORA Logical OR 
DEC Decrement memory ROL Rotate left 
*EOR Logical exclusive OR ROR Rotate right 
INC Increment memory *SBC Subtract with carry 
*LDA Load accumulator *STA Store accumulator 


Neen aa 


Unmarked commands are available with X register as index only. Commands marked * 


may use either register, whereas the one marked ** can oniy use the Y register. 
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INDIRECT ADDRESSING 


Indirect addressing allows us to read or write toa memory address which is not knownat 
the time of writing the program! Crazy! Not really, the program itself may calculate the 
actual address to be handled. Alternatively, a program may contain within it several tables 
of data which are all to be manipulated in a similar manner. Rather than writing a separate 
routine for each, a general purpose one can be developed, with the address operand being 
‘seeded’ on cach occasion the routine is called. 

Indirect addressing's beauty is that it enables the whole of the Oric’s memory map to be 
accessed with a single two byte instruction. To distinguish indirect addressing from other 
addressing modes, the operands must be enclosed in brackets. 

Pure indexed addressing is only available to one instruction—the jump 
instruction—which is mnemonically represented by JMP. We will look at JMP’s function 
in more detail during the course of Chapter 13, but suffice to say for now that it is the 
6502's equivalent of BASIC’s GOTO statement. (Though it does of course jump to an 
address rather than a line number.) 

A typical indirect jump instruction takes the form: 


JMP (#22) 


The address specified in the instruction is not the address jumped to, but is the address of 
the location where the jump address is stored. In other words, don’t jump here but to the 
address stored here! 


Operation: 
mew [ee [2 | ww 
#24 


#23 | 96 
422 | 00 


From the operational example we can see that location #22 contains the low byte of the 
address, and location #23 the high byte. These two locations, which act as temporary 
stores for the address, are known as a vector. Executing JMP (#22) in this instance will 
cause the program to jump to the location #9680. 

Program 12 illustrates the use of an indirect jump. The machine code for this program is 
stored in two different areas of memory identified by VECT and CODE (lines 20 and 38). 
The machine code at VECT (lines 148 to 180) is responsible for setting up the vector itself. 
It uses the two zero page locations #70 and #71, and in effect performs a machine code 
DOKE to place #9609 into these locations. Note that, as always with the 6502, the low byte 
is stored first. Line 18@ then performs the indirect jump to #9600 via #70. The machine 
code at #9600 places a row of asterisks across the top of the TEXT mode screen. 


Program 12 


10 REM * * INDIRECT JUMPING * * 
20 VECT = #490 

30 CODE = #9600 

46 FOR LOOP =@ TO 10 

50 READ BYTE 

60 POKE VECT + LOOP, BYTE 
76 NEXT LOOP 

86 FOR LOOP = @ TO 10 


90 READ BYTE 

108 POKE CODE + LOOP, BYTE 
116 NEXT LOOP 

128 

138 REM * * M/C DATA * * 

135 REM * * DATA FOR VECT * * 


140 DATA #A9, #00 : REM LDA @@ 
15@ DATA #85, #70 : REM STA #70 
168 DATA #A9, #96 : REM LDA @#96 
176 DATA #85, #71 : REM STA #71 
188 DATA H6C, #70, #00 : REM JMP (#70) 
196 REM * * DATA FOR CODE * * 

200 DATA #A2, #28 : REM LDX @#28 
216 DATA #A9, #2A : REM LDA @“*" 
220 DATA #9D, #A7, #BB : REM STA #BBA7, X 
230 DATA #CA : REM DEX 

246 DATA #D®@, #FA : REM BNE -6 
250 DATA #60 : REM RTS 

260 

270 REM * * SET UP & EXECUTE * * 

280 CLS 


296 CALL (VECT) 


POST-INDEXED INDIRECT ADDRESSING 


Post-indexed addressing is a little like absolute indexed addressing, but in this case, the 
base address is stored in a zero page vector which is accessed indirectly. 


Operation: 


LDA (#22), Y | Bi | 22 | 
Y register | 20 | 


Accumulator 


#23 | 04 | 
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In the example above, the base address is stored in the vector at #22 and #23. The 
contents of the Y register (#20) are added to the address in the vector (#49) to give the 
actual address (#420) of the data. It should be obvious that this form of indirect 
addressing allows access to a 256 byte range of locations. In the case above, any location 
from #480 to #4FF is available by setting the Y register accordingly. 

Program 13 uses post-indexed indirect addressing to move a line of screen memory from 
the upper to the lower half of the screen. 


Program 13 


1@ REM * * INDIRECT ADDRESSING * * 
20 CODE = #4006 

30 FOR LOOP = @ TO 12 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 

68 NEXT LOOP 


70 

80 REM * * M/C DATA * * 

90 

108 DATA #A®Q, #00 : REM LDY @#00 
118 DATA &A2, #27 : REM LDX @#27 
120 DATA #BI, #70 : REM LDA (#76), Y 
136 DATA 491, #72 : REM STA (#72), Y 
149 DATA #C8 : REM INY 

156 DATA #CA : REM DEX 

168 DATA #D#, #F8 : REM BNE -9 

178 DATA #60 : REM RTS 

186 

198 REM * * SET UP & EXECUTE * * 
200 CLS 
210 DOKE #70, 4BBAA : REM screentop 
220 DOKE #72, HBCEA : REM screenbottom 


238 PRINT “INDIRECT ADDRESSING” 
248 CALL (CODE) 


When RUN the two addresses, screentop and screenbottom, are DOKEd into the four 
zero page locations starting from #70. Once the screen is cleared, the title is printed at the 
top of the screen (line 230). On calling the machine code (line 240) the Y register is 
initialized to zero (line 100) and the X register loaded with the number of bytes to be 
moved (line 110). The byte at the address obtained when the contents of the Y register are 
added to the address stored in the vector corresponding to screentop, is loaded into the 
accumulator using indirect addressing (line 120). This byte is then stored at the address 
given by adding the Y register’s contents to the address held in the vector corresponding to 
screenbottom (line 130). The Y register is then incremented (line 140) and the X register 
decremented and checked for zero (lines 150 and 160). 


PRE-INDEXED ABSOLUTE ADDRESSING 


This addressing mode is used if we wish to indirectly access a whole series of absolute 
addresses which are stored in zero page. 


Operation: 


LDA (#70,X) 


X register 


#75 
#74 
#73 
#72 
#7] 
#70 








#74 


#1807 Accumulator 


Address of data 


Other vectored addresses, accessed by loading 
X register with @ or 2 


Here the contents of the X register (404) are added to the zero page address (#70) to give 
the vector address (#74). The two bytes here are then interpreted as the actual address of 
the data (#1807). Setting the X register to #02 gives indirect access to the vector address 


HISAA. 


A list of instructions which can be used with pre- and post-indexed addressing is shown’ 


in Table 10.4. 


Table 10.4 





Pre- and post-indexed indirect addressing instructions 


ADC 
AND 
CMP 
EOR 
LDA 
ORA 
SBC 

STA 


Add with carry 
Logical AND 
Compare memory 
Logical exclusive OR 
Load accumulator 
Logical OR 

Subtract with carry 
Store accumulator 





IMPLIED AND RELATIVE ADDRESSING 


Two other modes of addressing are available with the 6502 namely, implied addressing 
and relative addressing. We will be dealing with both of these addressing modes during 


the course of the next few chapters. 
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LOOK-UP TABLES 


; Look-up tables can provide an easy way out of what might otherwise be a complicated 
piece of machine code—such as calculating the square roots of equations. Asan example, 
let's develop a machine code program to convert degrees Centigrade into degrees 
Fahrenheit. The formula for this is: 


°F = 1.8 (°C) + 32 


As can be scen, a decimal multiplication (1.8 X C) is required, followed by an addition. 
This is both time consuming and somewhat painful to the grey matter! By providing the 
relative Fahrenheit values precalculated in a table, the Centigrade value can be used as the 
index to the table to obtain the equivalent Fahrenheit value. 


Program 14 


19 REM * * LOOK-UP TABLE * * 
20 REM * * ‘HIMEM 49600" * * 

36 CODE = #9660 

49 FOR LOOP = @ TO 9 

50 READ BYTE 

60 POKE CODE + LOOP, BYTE 
70 NEXT LOOP 

86 REM * * set up C to F table * * 
85 TABLE = #9500 

90 FORN=86TO 100 
160 DEGREE = (1.8 * N) + 32 
110 POKE TABLE + N, DEGREE 
120 NEXT N 


149 REM * * M/C DATA * * 

150 DATA #AE, #00, #40 : REM LDX #460 
168 DATA #BD, #00, #95 : REM LDA #9500, X 
170 DATA #8D, #00, #04 : REM STA #400 
189 DATA #60 : REM RTS 

190 

200 REM * * SET UP & EXECUTE * * 

205 CLS 

218 REPEAT 

226 INPUT “Centigrade value :”;C 

230 POKE #400, C 

240 CALL (CODE) 

250 PRINT ‘Fahrenheit value :”’; 

260 PRINT PEEK (#400) 

276 UNTIL C > 160 


Lines 8@ to 120 calculate the equivalent Fahrenheit values for the Centigrade 
temperatures in the range @° to 100°, and poke them into a table which has its base at 


#9500. The example shows how the Centigrade value is used as an index to obtain the 
Fahrenheit value. 


Example: Convert 3°C to Fahrenheit. 


LDA 49500, X 





Accumulator 


#9504 
#9503 
#9502 
#9501 


#9500 





Therefore 3°C is equivalent to 37°F. 
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ll Stacks of Fun 


THE STACK 


The stack is perhaps one of the more difficult aspects of the 6502 to understand, however it 
is well worth the time mastering as it lends itself to more efficient programming. Because 
of its importance the whole of Page #01 (that is memory locations 4#16@ through to 
#1FF) is given over to its operation. 

The stack is used as a temporary store for data and memory addresses that need to be 
remembered for use sometime later on during the program. For most purposes its 
operation is transparent to us. For example, when, during the course of a BASIC program 
a GOSUB is executed, the address of the next BASIC command or statement after it is 
placed onto the stack, so that the program knows where to return to on completion of 
the subroutine. The process of placing values onto the stack is known as pushing, whilst 
retrieving the data is called pulling. 

The stack has one important feature which must be understood—it is a /ast in, first out 
(LIFO) structure. What this means is that the last byte pushed onto the stack must be the 
first byte pulled from it. 

A useful analogy to draw here is that of a train yard. Consider a small spur line, onto 
which trucks 1, 2and 3 are pushed (see Figure 11.1). The first truck onto the line (truck 1) 
is at the very end of the line, truck 2, the second onto the line is in the middle, and the last 
truck (truck 3) is nearest the points. 


Truck 3 is last In and so will be first out. 





Figure 11.1 The stack—LIFO. 


It should now be fairly obvious that the first truck to be pulled off the spur must be the 
last truck pushed onto it, that is, truck 3. Truck 2 will be the next to be pulled from the line, 
and the first truck in will be the last one out. ; 

To help us keep track of our position on the stack, there is a further 652 register called 
the Stack Pointer. Because the stack is hardware item of the 6502, that is, it is actually 
‘wired’ into it, the ‘page number’ of the stack (#01) can be omitted from the address, and 
the Stack Pointer just points to the next free position in the stack. 


When the Oric is switched on (or a BREAK is performed) the Stack Pointer is loaded 
with the value 4FF—it points to the top of the stack—this means that the stack grows 
down the memory map rather than upas may be expected. Each time an item is pushed the 

Stack Pointer is decremented, and conversely, it is incremented when the stack is pulled. 


STACK INSTRUCTIONS FOR SAVING DATA 


The 6502 has four instructions that allow the accumulator and Status register to be pushed 
and pulled. They are: ; 


PHA Push accumulator onto stack 
PLA Pull accumulator from stack 
PHP Push Status register onto stack 
PLP Pull Status register from stack 


All four instructions use implied addressing and occupy only a single byte of memory. 


LDA @#FF Stack 










#1FF 
#1FE 
#1FD 
#1FC 
#1FB 
#1FA 


Accumulator [FF ] 


Stack Pointer 


PHA 

#1FF 

Accumulator [ FF ] #1FE 

“#1FD 
#1FC 
#1FB 


#1FA 


Stack Pointer 


LDA @#00: PHA 

#1FF 
#1FE 
#1FD 
‘#1EC 
#1FB 
#1FA 


Accumulator 


Stack Pointer 


Figure 11.2 Pushing items on to the stack. 
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The PHA and PHP instructions work ina similar manner, but on different registers. In 
both cases the source register remains unaltered by the instruction. Again PLA and PLP 
are similar in operation, but PLA conditions only the Negative and Zero flags, while PLP 
of course conditions all the flags. 

Consider the following sequence of instructions: 


TWOPUSH LDA @#FF \ place #FF in accumulator 
PHA \ push onto stack 
LDA @#00 \ place #00 in accumulator 
PHA \ push onto stack 


Figure 11.2 shows exactly what happens as this program is executed. The Stack Pointer 
(SP) at the start contains #FD and points to the next free location in the stack. The first 
two stack locations #FF and #FE hold the two byte return address (RTA) to which the 
machine code will eventually pass control. (This may be the address of the next BASIC 
instruction if a call to machine code has been made.) The subsequent stack locations are at 
present undefined and are therefore represented as ??. 

After the accumulator has been loaded with #FF it is copied onto the stack by PHA. 
Note that the accumulator’s contents are not affected by this operation. Once it has been 
pushed onto the stack, the Stack Pointer’s value is decremented by one to point to the next 
free location in the stack (4#FC). 

The accumulator is then loaded with 460 and this is pushed on to the stack at location 
#FC. The Stack Pointer is again decremented to the next free location (#FB). 

To remove these items from the stack the following could be used: 


TWOPULL PLA \ get #80 from stack 
STA #70 \ save it somewhere 
PLA \ get #HFF from stack 
STA 471 \ save it as well 


Figure 11.3 illustrates what happens in this case. The first PLA will pull from the stack 
into the accumulator the last item pushed onto it, which in this example is #00. The Stack 
Pointer is incremented, this time to point to the new ‘next free location’, #FC. As youcan 
see from the diagram the stack contents are not altered, but the #69 will be overwritten ifa 
further item is now pushed. The STA #7@ saves the accumulator value somewhere in 
memory so that it is not destroyed by the next PLA. This PLA restores the value #FF into 
the accumulator, and again increments the Stack Pointer. 

One thing should now be apparent—it is very important to remember the order in 
which items are pushed onto the stack, as they sus? be pulled in exactly the reverse order. 
If this process is not strictly adhered to then errors will certainly result, and could even 
cause your program to crash or hang-up! 

The following program shows how the stack can be used to save the contents of the 
various registers to be printed later. This is particularly useful for debugging those 
awkward programs that just will not work. 


REGSAVE PHP \ save Status register 
PHA \ save accumulator 
TXA \ transfer X into accumulator 
PHA \ save accumulator (X) 
TYA \ transfer Y into accumulator 
PHA \ save accumulator (Y) 


It is important to save the registers in the order shown. The Status register should be saved 
first so that it will not be altered by the subsequent transfer instructions which could affect 
the Negative and Zero flags, and the accumulator must be saved before its value is 
destroyed by cither of the index register transfer operations. 


PLA: #70 







Stack 
#1FF 
#1FE 
Accumulator TR 
[00 J ee 
Stack Pointer ae Oe ware 


PLA: STA #71 


Accumulator [FF ] 


Stack Pointer 


Figure 11.3 Pulling items from the stack. 


If the registers’ values had been saved to preserve them while another portion of the 
program was operating, we could retrieve them with: 


PLA \ pull accumulator (Y) 
TAY \ and transfer to Y register 
PLA \ pull accumulator (X) 
TAX \ and transfer to X register 
PLA \ pull accumulator 

PLP \ pull Status register 


There are two final stack associated instructions: 


TSX Transfer Stack Pointer to X register 
TXS Transfer X register to Stack Pointer 


We shall sce how and why the stack is used to save addresses in Chapter 13. 
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I? Looping 


LOOPS 


Loops allow sections of programs to be repeated over and over again. For example, in 
BASIC we could print ten exclamation marks using a FOR . . . NEXT loop like this: 


16 FOR NUM=8@TO9 
20 PRINT“! ; 
38 NEXT NUM 


In line 10 a counter called NUM is declared and initially set to zero. Line 20 prints the 
exclamation mark, and line 3@ checks the present value of NUM to see if it has reached 
its maximum limit. If it has not, the program adds one to NUM and branches back to 
print the next exclamation mark. 

To implement this type of loop in machine code we need to know how to control 
and use the three topics identified above; namely counters, comparisons and branches. 


COUNTERS 


It is usual to use index registers as counters, because they have their own increment and 
decrement instructions. 


INX Increment X register X=X+1 
INY Increment Y register Y=Y+tl 
DEX Decrement X register X=X-— 1 
DEY Decrement Y register Y = Y-— 1 


All these instructions can affect the Negative and Zero flags. The Negative flag is set if the 
most significant bit of the register is set following an increment or decrement 
instruction—otherwise it will be cleared. The Zero flag will only be set if any of the 
instructions cause the register concerned to contain zero. 

Note that incrementing a register which contains 4#FF will reset that register to #00, 
will clear the Negative flag (N = @) and will set the Zero flag (Z = 1). Conversely, 
decrementing a register holding #90 will reset its value to #FF, set the Negative flag and 
clear the Zero flag. 

There are two other increment and decrement instructions: 


INC Increment memory 


DEC Decrement memory 


These instructions allow the values in memory locations to be adjusted by one, for 
example: 

INC #70 \ add I to location #76 

DEC #420 \ subtract | from location #420 


Both instructions condition the Negative and Zero flags as described earlier. 


Program 15 shows how these instructions can be used, in this case to print ‘ABC’ on the 
screen. 


Program 15 


18 REM * * INCREMENTING A REGISTER * * 
20 CODE = #400 

36 FOR LOOP =@TO11 

48 READ BYTE 

50 POKE CODE + LOOP, BYTE 

68 NEXT LOOP 


70 

88 REM * * M/C DATA * * 

96 DATA HAS, #41 : REM LDA @“A”" 
108 DATA #85, #70 : REM STA #70 
116 DATA #AA : REM TAX 
120 DATA #E8 >: REM INX 
138 DATA #86, #71 >: REM STX #71 
149 DATA #E8 >: REM INX 
150 DATA #86, #72 > REM STX 472 
169 DATA #60 : REM RTS 
170 
180 REM * * SET UP & EXECUTE * * 

198 CLS 


195 CALL (CODE) 

200 FOR LOC =@ TO 2 

210 NUM = PEEK(#70 + LOC) 
220 PRINT CHRS$(NUM) 

230 NEXT LOC 


COMPARISONS 


There are three compare instructions: 


CMP Compare accumulator 
CPX Compare X register 
CPY Compare Y register 
The contents of any register can be compared with the contents of a specified memory 
location, or as is often the case, the value immediately following the mnemonic. The 
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values being tested remain unaltered. Depending on the result of the comparison, the 
Negative, Zero and Carry flags are conditioned. How are these flags conditioned? Well, 
the first thing the 6502 does is set the Carry flag (C = 1). It then subtracts the specified 
value from the contents of the register. If the value is less than, or equal to the register 
contents, the Carry flag remains set. If the two values are equal the Zero flag is also set. If 
the Carry flag has been cleared, it means that the value was greater than the register 
contents, and a borrow occurred during the subtraction. The Negative flag is generally 
(but not always) set when this occurs—this is only really valid for two's complement 
compares. Table 12.1 summarizes these tests. 

Examples of compare instructions include: 


CMP @#41 
CPY #420, X 
CPX #9600 


Table 12.1 


Register less than data 
Register equal to data 
Register greater than data 





BRANCHES 


Depending on the result of a comparison, the program will need either to branch back to 
repeat the loop, branch to another point in the program, or just simply continue. This type 
of branching is called conditional branching, and eight instructions enable various 
conditions to be evaluated. The branch instructions are: 


BNE Branch if not equal Z=6 
BEQ Branch if equal Z=1 
BCC Branch if Carry clear C=0 
BCS Branch if Carry set C=1 
BPL Branch if plus N=0 
BMI Branch if minus N=1 
BVC Branch if overflow clear V=98@ 
BVS Branch if overflow set V=1 


Let’s now rewrite the BASIC program to print ten exclamation marks (see page 54) in 
machine code. 


Program 16 


10 REM * * 10! MARKS * * 
20 CODE = #490 

30 FOR LOOP=@ TO 12 

49 READ BYTE 

50 POKE CODE + LOOP, BYTE 
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68 NEXT LOOP 


70 

88 REM * * M/C DATA * * 

98 DATA #A2, #60 : REM LDX @400 
100 DATA #A9, #21 : REMLDA@'‘! 
118 DATA #9D, #AA, #BB : REM STA &BBAA, X 
120 DATA #E8 >: REM INX 
130 DATA #E@, #0A : REM CPX @1@ 
146 DATA #D@, #F8 : REM BNE -8 
158 DATA #60 : REM RTS 
160 
178 REM * * SET UP & EXECUTE * * 

188 CLS 


198 CALL (CODE) 


Lines 99 and 100 initialize the X register and place the ASCII code for an exclamation 
mark in the accumulator. After the ‘!" is stored in screen memory (line 110) the X register 
is incremented (line 120) and line 13@ tests to see if all the exclamation marks have been 
printed. If the comparison fails (X < > 10) the Zero flag will remain clearand the BNE of 
line 148 will be executed, causing the program to branch back to line 110. If the 
comparison is true, the Zero flag is set and the RTS of line 15@ executed. 

We can make this program more efficient. Whenever a register is used as a loop counter, 
and only as a loop counter, it 1s best to write the code so that the register counts down 
rather than up. Why? Well, you may recall from Chapter 6 that when a register is 
decremented such that it holds zero the Zero flag is set. Using this principle, the 
CPX @ 10 can be completely removed, and the program rewritten as shown in Program 17. 


Program 17 


18 REM * * DOWN COUNT * * 

20 CODE = #400 

30 FOR LOOP = 6 TO 12 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 
68 NEXT LOOP 


70 

88 REM * * M/C DATA * * 

98 DATA #A2, HOA : REM LDX @16 

108 DATA #A9, #21 >: REM LDA @'! 

1186 DATA #9D, #AA, #BB : REM STA #4BBAA, X 
120 DATA #CA : REM DEX 

140 DATA #D®@, HFA : REM BNE -6 

15@ DATA #60 : REM RTS 

160 


176 REM * * SET UP & EXECUTE * * 
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186 CLS 
198 CALL (CODE) 


If you look closely at the listing you will notice that the BNE opcode is followed by a single 
byte and not an address as you may have expected. This is known as the displacement and 
the mode of addressing is called relative. The operand, in this case HFA, tells the processor 
that a backward branch of 6 bytes is required. 

To distinguish branches backwards from branches forwards signed binary is used. A 
negative value means a backward branch while a positive number indicates a forward 
branch. Obviously, it is important to know how to calculate these displacements—so let's try 
it. 

Before sitting down in front of your Oric it is always best to sit down and write your 
machine code program. While it is perfectly feasible to write it at the keyboard, this nearly 
always leads to errors in the coding (I speak from experience!). 

To make it clear just where loops are branching to and from, you can use /abels. With 
Program 17, for example, you can write the mnemonics using the label LOOP to mark the 
destination of the branch, as shown in Table 12.1. 








Table 12.1 
Label Mnemonics Comments 
START Code begins 
LDX @10 Loop counter 
LDA @‘I’ ASCII Code for ! 
LOOP Branch destination 
STA #BBAA, X_ Store in screen memory 
DEX X=X-1 
BNE LOOP Continue until X = @ 
RTS All done! 





Once this is done, we can look up the relevant machine code and insert it into the table. To 
calculate the branch displacement, just count the number of bytes from the displacement 
byte itself back to the label LOOP. 


LOOP 
STA #BBAA, X 3 bytes 
DEX 1 byte 
BNE LOOP 2 bytes 


This gives a total displacement of 6 bytes. Note that the relative displacement is included in 
the count (although it is not known at the time of calculation) because the Program Counter 
will be pointing to the instruction following it. 

To convert this displacement to its backward branch signed binary form, obtain the 
two’s complement value (see Chapter 3 if you need some refreshing on just how to do this). 


00000110 (6) 
11111001 

+ 1 

11111010 (-6 = #FA) 


Since all branches are two bytes long, effective displacements of —126 bytes (—128 + 2) 
and +129 bytes (127 + 2) are possible. 


To demonstrate the use of a forward branch enter and RUN the following program, 
which will display a Y if location #408 contains a ‘@’ or an N otherwise. 


Program 18 


10 
20 
30 
40 
50 
60 
70 
80 
96 
100 
110 
120 
130 
140 
150 
160 
170 
180 
199 
200 
210 


REM * * FORWARD BRANCHING * * 
REM * * SET HIMEM 49600 * * 
CODE = 49600 
FOR LOOP = @ TO 16 
POKE CODE + LOOP, BYTE 
READ BYTE 
NEXT LOOP 


REM * * M/C DATA * * 

DATA #AD, #00, #04 >: REM LDA #400 
DATA #F@, #06 : REM BEQ +6 
DATA #A9, #4E : REM LDA @‘N' 
DATA 48D, #AA, #BB : REM STA #BBAA 
DATA #60 :° REM RTS 

DATA #A9, #59 : REM LDA @‘yY’ 
DATA 48D, #AA, #BB : REM STA &BBAA 
DATA #60 : REM RTS 


REM ** SET UP & EXECUTE * * 
CLS 
CALL (CODE) 


When Program 18 is RUN, the contents of location #40@ are loaded into the 
accumulator (line 100). If the contents are #00, the Zero flag is set and the BEQ of line 110 
performed, thus jumping over the bytes responsible for storing the *N" into screen 
memory. Because the branch is in a forward direction, a positive value (that’s one less than 
#80) is used as the displacement. The labelled mnemonics I used to calculate the 
displacement are shown in Table 12.2. 


Table 12.2 
Label Mnemonics Comments 
START At 49600 


LDA #400 Get byte 
BEQ ZERO _ Branch if Z=0 
LDA @'N' ASCII code for N 
STA #BBAA Store in screen memory 
RTS Back to BASIC 
ZERO LDY @'‘Y* ASCII code for Y 
STA #BBAA Store in screen memory 
RTS Back to BASIC 
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Counting the bytes from the byte after the branch to the label ZERO we get: 


BEQ ZERO 

LDA @'‘N’ 2 bytes 
STA #BBAA 3 bytes 
RTS 1 byte 


ZERO 


a total of 6 bytes. Appendix 4 contains two tables which can be used to convert the byte 
count into the correct displacement rather than calculating it by hand in this way. 


MEMORY COUNTERS 


Invariably programs that operate on absolute addresses will require routines that are 
capable of incrementing or decrementing these double byte valucs. A typical case being a 
program using post-indexed indirect addressing that needs to sequentially acecss a whole 
range of consecutive memory locations. The following two programs show how this can 
be done. First, incrementing memory addresses. 


Program 19 


10 REM * * INCREMENTING MEMORY * * 
26 REM * * SET HIMEM 49600 * * 

30 MCODE = #96006 

49 COUNTER = #400 

5@ DOKE COUNTER, 0 

68 FOR LOOP =@TO8 

70 READ BYTE 

80 POKE MCODE + LOOP, BYTE 

90 NEXT BYTE 


100 

116 REM * * M/C DATA * * 

120 DATA #EE, #00, #04 : REM INC #400 
138 DATA &#&D®@, #03 : REM BNE +3 
140 DATA #EE, 401, #40 : REM INC #461 
15@ DATA #68 : REM RTS 

160 

178 REM * * SET UP & EXECUTE * * 

186 REPEAT 


190 PRINT DEEK (COUNTER) 
200 CALL (MCODE) 

210 GET A$ 

220 UNTIL A$ =“S” 


Here the relative machine code is contained in the lines 12@ to 149. Each time the routine is 
called, the low byte of #400 is incremented. Each time it goes from #FF to #00 the Zero 
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flag is set and the branch (line 13@) will not take place—and therefore the high byte of the 
counter at #401 is incremented. 


Decrementing a counter is a little less straightforward. 


Program 20 

10 REM * * DECREMENTING MEMORY * * 

20 REM * * SET HIMEM 49606 * * 

36 MCODE = 49600 

40 COUNTER = #400 

5@ DOKE COUNTER, #FFFF 

66 FOR LOOP =6TO 11 

70 READ BYTE 

80 POKE MCODE + LOOP, BYTE 

96 NEXT BYTE 

100 

116 REM * * M/C DATA * * 

128 DATA HAD, #00, 404 >: REM LDA #400 
130 DATA #D8®@, #63 : REM BNE +3 
140 DATA ACE, #61, #04 : REM DEC #4@1 
15@ DATA &CE, #00, #064 : REM DEC #460 
160 DATA #60 : REM RTS 

170 

186 REM * * SET UP & EXECUTE * * 

198 REPEAT 
200 PRINT DEEK (COUNTER) 
210 CALL (MCODE) 
220 GET A$ 
230 UNTIL A$ = “S" 


The accumulator is first loaded with the low byte of the counter at #400 (line 120), this 
procedure will condition the Zero flag. If it is set, the low byte of counter must contain 
#00, and therefore the high byte needs to be decremented (line 140). Otherwise it is skipped 
and only the low byte is decremented. Either of the index registers could have been used in 
place of the accumulator in line 120. If all registers are in use the following alternative can 
be employed: 


INC #400 
DEC #406 
BNE LSBDEC 
DEC #401 


LSBDEC DEC #400 


The process of first incrementing and then decrementing the low byte of #400 will 
condition the Zero flag in the same manner as a /oad instruction. 
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13 Subroutines and Jumps 


SUBROUTINES 


If you are familiar with BASIC’s GOSUB and RETURN statements you should have little 
difficulty understanding the two assembler equivalents: 

JSR Jump save return 

RTS Return from subroutine 
If you are not familiar, I will explain. 

Quite often during the course of writing a program you will find that a specific 
operation must be performed more than once, perhaps several times. Rather than typing 
in the same group of mnemonics on every occasion, which is both time consuming and 
increases the programs’ length, they can be entered once, out of the way of the main 


program flow, and called when required. Not every piece of repetitive assembler 
warrants being coded into a subroutine, however. For example: 


INX : DEY : STA #22 


is quite common (or something very similar) however, when assembled it only occupies 
four bytes of memory, which is the same memory requirement as a JSR... RTS call. 
Nothing is to be gained by introducing a subroutine here then, in fact, it will actually slow 
the program operation down by a few millionths of a second! On the other hand: 


CLC: LDA 422: ADC @#12 : STA #23 


might well warrant its own subroutine call as, if absolute addressing is employed, it may be 
up to ten bytes in length. 
Let’s now look at a short program which employs several subroutine calls. 


Program 21 


10 REM * * SUBROUTINE DEMO* * 
20 REM * * SET HIMEM 49600 * * 
30 CODE = 49600 

40 SUBR = #400 

5@ REM * * set up subroutine * * 

68 FOR LOOP =6TO 3 

70 READ BYTE 

86 POKE SUBR + LOOP, BYTE 


96 NEXT LOOP 

100 REM * * sct up main m/code * * 
118 FOR LOOP =@6TO 15 

120 READ BYTE 

130 POKE CODE + LOOP, BYTE 
140 NEXT LOOP 

150 

160 REM * * M/C DATA * * 

176 REM * * subroutine * * 


18@ DATA #9D, #AA, #BB ‘+ REM STA ABBAA, X 

199 DATA #60 : REM RTS 

200 REM * * main m/code * * 

216 DATA #A9, #41 : REMLDA@“A"  « + 

220 DATA #AB : REM TAY i. 

238 DATA #A2, #00 : REMLDX @00 »-~+ 

240 DATA #20, #00, #04 : REM JSR #400 

250 DATA #E8 : REM INX eae ferns? 

260 DATA #C8 : REM INY i A 
270 DATA 498 > REMTYA os: =a eS 
286 DATA #E@, HIA : REM CPX @26 °°. CVE 
298 DATA #DO, #F6 : REMBNE-10 «{ tov, b2\\ 
300 DATA 460 : REM RTS 

310 

320 REM * * SET UP & EXECUTE * * 

330 CLS 


340 CALL (CODE) 


The subroutine itself is located in the user machine code area. As the subroutine is only 
four bytes long it would really be much more efficient to include it in the main body of the 
program, however, for the purposes of demonstration is has been deliberately kept short. 
The main program is stored from #9600 above a reset HIMEM. 

The program itself uses absolute indexed addressing to print the alphabet across the 
screen. When called, the ASCII code for the letter ‘A’ is placed into the accumulator (line 
210) and then copied into the Y register using the appropriate transfer instruction (line 
220). This is important because we will require the register to increment this ASCII code in 
order to obtain the codes for the rest of the letters of the alphabet, and of course, the 
accumulator has no direct increment instruction (though we could have used CLC, 
ADC @)). 

After the indexing X register is initialized to zero (line 23), the first of 26 subroutine 
calls is performed (line 240). The subroutine, located way down the memory map at #469, 
is responsible for placing the ASCII character code (and therefore the character) into 
screen memory (line 180). The RTS opcode (line 198) then returns control back to the 
calling program—nor BASIC. The index registers are both incremented (lines 25@ and 
260), the next ASCII character code is placed into the accumulator (line 270) and the 
program is repeated a further 25 times (lines 280 and 299). 

Now that we have taken a general overview of subroutine calls and their functions it will 
be useful to see just how they manage to do what they do. 
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The two instructions JSR and RTS must perform three functions between them. Firstly, 
the current contents of the Program Counter must be saved so that control may be 
returned to the calling program at some stage. Secondly, the 6502 must be told to execute 
the subroutine once it arrives there. Finally, program control must be handed back to the 
calling program. 

The JSR instruction performs the first two requirements. To save the return address it 
pushes the two byte contents of the Program Counter onto the stack. The Program 
Counter at this stage will hold the address of the location containing the third byte of 
the three which constitute the JSR instruction. After pushing the Program Counter 
onto the stack, the operand specified by JSR is placed into the Program Counter, which 
effectively transfers control to the subroutine. 

Figure 13.1 shows how these operations take place, and in particular, their effect on the 
stack. At the time the 6502 encounters the JSR instruction the Program Counter is 
pointing to the second byte of the two byte operand (Figure 13.]a). The microprocessor 
pushes the contents of the program Counter onto the stack, low byte first (Figure 13.1b), 
and then copies the subroutine address into the Program Counter (Figure 13.Ic). 


a) 


Main 
program 


b) 






c) Subroutine 


Figure 13.1 Steps taken by a JSR instruction. 


When the RTS instruction is encountered at the end of the subroutine, these actions are 


reversed. The return address is pulled from the stack and incremented by one (Figure 13.2) 


as it is replaced into the Program Counter, so that it points to the instruction after the 
original subroutine call. 


Subroutine 


a) 


Figure 13.2 Steps taken by an RTS instruction. 


b) Stack 
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c) 
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Figure 13.2. (Cont.). 


PASSING PARAMETERS 


Nine times out of ten a subroutine will require some data to work on, and this will have to 
be passed into the subroutine by the main program. There are three general ways in which 
information or parameters can be passed into subroutines, these are: 


1. Through registers. 
2. Through memory locations. 
3. Through the stack. 


Let's look at each of these methods in turn. 
Through registers 


This is quite obviously the simplest method particularly because it can keep the subroutine 
independent of memory. Because only three registers are available though, only three 
bytes of information can be conveyed. The registers may themselves contain vital 
information, so this would need to be saved, possibly on the stack, for future restoration. 


Through memory 


This is probably the easiest method if numerous bytes are being passed into the 
subroutine. The best way is to use memory between locations #400 and #426 inclusive, 
because this is reserved for user applications. If the subroutine uses several bytes of 
memory, a neat way of accessing them is to place the relative start address of the data in 
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the X register, and then use absolute indexed addressing with #400 as the operand as 
LDX #0 
JSR Subroutine 


follows: 
Sa Subroutine LDA #400, X 


INX 
CPX @#10 
BNE Subroutine 
RTS 
The disadvantage of using memory locations to pass parameters is that it ties the 


subroutine to a given area, making it memory dependent. However, on most occasions 
this does not really matter. 


Through the stack 


Passing parameters through the stack needs care, since the top of the stack will contain the 
return address. This method also requires two bytes of memory in which the return 
address can be saved after pulling it from the stack (though, of course, the index registers 
could be used). If the stack is used, the subroutine needs to commence with: 


PLA \ pull low byte 
STA ADDR \ and save it 
PLA \ pull high byte 
STA ADDR + 1 \ and save it 


The STA instructions can be replaced by TAX and TAY respectively. It is common 
practice when using the index registers to hold an address, to place the low byte in the X 
register and the high byte in the Y register. 

Once the parameters have been pulled from the stack the return address can be pushed 
back on to it with, 


LDA ADDR + | 
PHA 

LDA ADDR 
PHA 


Remember, the stack is a LIFO structure, so the bytes need to be accessed and pushed in 
the reverse order from that in which they were pulled and saved. 

If a variable number of parameters is being passed into the subroutine, the actual 
number can be ascertained each time by evaluating thecontents of the Stack Pointer. This 
can be carried out be transferring its value to the X register with TSX, and incrementing 
the X register each time the stack is pulled until, say, #FF is reached, indicating the stack 
is empty. The actual value tested for will depend on whether any other subroutine calls 
were performed previously—making the current one a nested subroutine. The value # FF 
is therefore just a hypothetical case and assumes nothing other than that data is present 
on the stack. 





JUMPS 


The JMP instruction operates in a similar manner to BASIC’s GOTO statement in that it 
transfers control to another part of the program. In machine code, however, an absolute 
address is specified rather than a line number (which does not, of course, exist in machine 
code). The instruction operates simply by placing the two byte address specified after the 
opcode into the Program Counter, effectively producing a jump. JMP will generally be 
used to leapfrog over a section of machine code that need not be executed because a test 


failed. For example: 

BCC OVER 
JMP SOMEWHERE 

OVER LDA BYTE 
ASLA 
INX 
DEY 

SOMEWHERE STA TEMP 

Here, if the Carry flag is clear, the jump instruction will be skipped and the code of 


OVER executed. If the Carry flag is set the test will fail, the JMP will be encountered and 
the code of OVER bypassed. 


A further use of JMP, the ‘indirect jump’, was detailed in Chapter 10. As we saw, the 


address that is actually jumped to Is stored in a vector, the address of which is specified in 
the instruction. JMP (#426) being an example. 
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14 Shifts and Rotates 


Basically, these instructions allow the bits in a single byte to be moved one bit to the left or 
one bit to the right. There are four instructions available: 


ASL Arithmetic shift left 
LSR Logical shift right 
ROL Rotate left 

ROR Rotate right 


All of these instructions may operate directly on the accumulator, or on a specified 
memory byte: 


ASLA \ arithmetic shift left accumulator 
ROL #70 \ rotate left location #70 


Let's investigate each command in more detail. 


ARITHMETIC SHIFT LEFT 


ASL moves the contents of the specified byte left by a single bit. 


Carry flag 


coon [oPe[e]=]=[*[=]*[=}— 
woo [o] Teele [Teele 


Bit 7 (B,) is shifted into the Carry flag, and a ‘O° takes the place of bit @ as the rest of the bits 
are shuffled left. The overall effect is to double the value of the byte in question. 


Example: 


Accumulator 


c 
LDA @#42 \_ load accumulator with #42 01900010 


Cc Accumulator 


ASLA \ shift accumulator left 100001080 


The accumulator now holds #84, twice the original value! 


A further example of ASL is given by Program 22 which asks for a number (less than 
64), multiplies it by four using ASL A, ASL A, and prints the answer. 


Program 22 


10 
20 
30 
40 
50 
60 
70 
80 
90 
100 
110 
120 
130 
140 
150 
160 
170 
180 
196 
200 
216 


REM * * MULTIPLY BY FOUR * * 
CODE = #400 
FOR LOOP = @ TO 8 

READ BYTE 

POKE CODE + LOOP, BYTE 
NEXT LOOP 


REM * * M/C DATA * * 

DATA #AD, #20, 404 : REM LDA #420 
DATA #0A : REM ASLA 
DATA #0A : REM ASLA 
DATA #8D, #20, #04 : REM STA 4420 
DATA #60 : REM RTS 


REM * * SET UP & EXECUTE * * 
CLS 

INPUT ‘*Number to multiply”; NUM 
POKE #420, NUM 

CALL (CODE) 

PRINT “Result: ”; 

PRINT PEEK (#420) 


LOGICAL SHIFT RIGHT 


LSR is similar to ASL except that it moves the bits in the opposite direction, with bit @ (Bo) 


jumping into the Carry flag and a @ following into the spot vacated by bit 7 (B,). 


Carry 
Byte flag 


sionasne—[o Ta [o[a]o[o[a[a}-[e | 


After shift 


Ea Ee 
6 


9 


ane instruction could well have been called arithmetic shift right because it effectively 
vides the byte being shifted by two. For example: 


Accumulator 


Cc 

LDA @#42 \_ load accumulator with #42 610000180 
Cc 

LSRA \ shift accumulator right | o | 066100001 


The accumulator now holds 421, half the original value. 


Using: 
LSR A: BCS Elsewhere 
or, 
LSR A : BCC Somewhere 


is a good efficient way of testing bit @ of the accumulator. 
Program 23 tests the condition of bit @ of an input ASCII character by shifting it into the 
Carry flag position. If the carry is clear a zero is printed, if set—a one is printed instead. 


Program 23 


10 REM * * TEST BIT @ * * 

26 CODE = #406 

36 FOR LOOP=@TO II 

40 READ BYTE 

58 POKE CODE + LOOP, BYTE 
69 NEXT LOOP 


70 

80 REM * * M/C DATA * * 

90 DATA 4&AD, #20, #04 >: REM LDA #420 
168 DATA #4A >: REMLSRA 
116 DATA #ASY, #00 : REM LDA @0 
120 DATA #69, #00 : REM ADC @0 
130 DATA #8D, #20, #04 >: REM STA #420 
140 DATA #60 : REM RTS 
150 
166 REM * * SET UP & EXECUTE * * 

178 CLS 


180 INPUT “Test number’; NUM 
196 POKE #420, NUM 

200 CALL (CODE) 

216 PRINT PEEK (#420) 


ROTATE LEFT 


This instruction uses the Carry flag as a ninth bit, rotating the whole byte left one bit ina 
circular motion, with bit 7 moving into the Carry flag, which in turn moves across to bit 9. 


Byte 


Carry 
flag 


= {elajeteleatalc 


After rotate: 





ROL provides an easy method of testing any of the four bits constituting the upper 
nibble of the accumulator. The desired bit is rotated into the bit 7 position, thus setting or 
clearing the Negative flag as appropmiate. 


Example: test bit 5 of accumulator. 


Accumulator AF 1@1@1111 N= 1 


Carry flag 


ROLA / rotate bit 6 into the bit 7 position 


Accumulator @18111180 N=0 


Carry flag 


[= IL] 


ROLA / rotate bit 5 into the bit 7 position 


Accumulator BC 101111601 T= | 


Carry flag 


The Negative flag is now set, indicating that bit 5 of the accumulator was set. 
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ROTATE RIGHT 
Works just like ROL except the bits move to the right. 


‘Byte 


Carry 
flag 


jejejalalals}a} a 


After rotate: 





Example: ROR accumulator containing #8F. 


CLC \_ clear Carry flag 
LDA @#8F \ __ load accumulator with #8F 


Accumulator 10001111 
Carry flag 


ROR \ rotate right 


Accumulator 01000111 
Carry flag + | 


LOGICALLY SPEAKING 


If you need to shift (or rotate) the contents of a particular location several times, itis more 
efficient to load the value into the accumulator, shift (or rotate) that and store it back, 
than to manipulate the location directly. 
For example, to rotate location #1234 to the right four times, we could use: 
ROR #1234 
ROR #1234 
ROR #1234 


ROR #1234 
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This uses twelve bytes of memory, four for the instructions and eight for addresses. 
Alternatively: 

LDA #1234 

ROR A 

RORA 

ROR A 

ROR A 

STA #1234 


uses two bytes less and is 25% quicker in operation. 
So far we have only considered shifting and rotating single bytes. By using 


combinations of instructions it is possible to perform similar operations on two byte 
values such as #0123. 


To perform an overall ASL on two bytes located at HIGH and LOW, ASLand ROL 
are used in conjunction: 


ASL HIGH \ shift bit 7 by LOW into Carry flag 
ROL LOW \ rotate it into bit @ of HIGH 


By exchanging the commands an overall LSR on the same two bytes can be performed: 


LSR HIGH \ shift bit @ HIGH into Carry flag 
ROR LOW \ rotate it into bit 7 of LOW 


Note that the bytes are manipulated in the reverse order because we wish to move the 
bits in the opposite direction. As with single byte shifts, the two byte values can be doubled 
or divided in half. 

Two byte rotates to move the bits in a circular manner, are simply rotation operations 
performed twice! However, as with two byte shifts, it is important to get the byte rotation 
order correct. 

A two byte ROR is performed with: 


ROR HIGH \ rotate bit @ of HIGH into Carry flag 
ROR LOW \ and on into bit 7 of LOW 


While two byte ROLs are implemented with: 


ROL LOW \ rotate bit 7 of LOW into Carry flag 
ROL HIGH \ and on into bit @ of HIGH 


Finally, moving back to single byte shifts, to shift the contents of the accumulator right 
one bit while preserving the sign bit, use the following technique: 


TAY \ save accumulator in Y register 

ASL A \ move sign bit (bit 7) into Carry flag 

TYA \ restore original value back into 
accumulator 

ROR A \ rotate right moving sign bit back 
into bit 7 


The Y register has been used as a temporary store for the accumulator. We could have 
used the X register or a memory location with equal effect. 
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PRINTING BINARY! 


Quite often, it is necessary to know the binary bit pattern that a register or memory 
location holds. This is particularly true in the case of the Status register when the 
condition of its flags can often provide a great deal of information about the way a 
program is running. 

Program 24 shows how the binary value of a byte can be printed. It uses the Status 
register’s contents at the time the program is RUN as an example. 


Program 24 


18 REM * * SR IN BINARY * * 

15 REM * * HIMEM 49600 * * 

20 CODE = 49600 

30 FOR LOOP = 6 TO 20 

40 READ BYTE 

50 POKE CODE + LOOP, BYTE 
68 NEXT LOOP 


70 

86 REM * * M/C DATA * * 

96 DATA H@8 : REM PHP 

106 DATA #68 >: REM PLA 

116 DATA #8D, #00, #04 >: REM STA 4400 
126 DATA #A2, #08 : REM LDX @#8 
130 DATA 4@E, #00, 404 : REM ASL #400 
148 DATA #A9, #00 : REM LDA @#@ 
150 DATA #69, #00 : REM ADC @k0@ 
160 DATA #9D, #00, #04 : REM STA #400, X 
176 DATA #CA : REM DEX 

188 DATA #D®@, #F3 : REM BNE -13 
199 DATA #60 : REM RTS 
200 
210 CLS 


220 _PRINT “Status Register” 
230 AN V—BDIZC” 


248 CALL (CODE) 

25@ FOR LOOP =8 TO 1 STEP —1 
260 PRINT PEEK (#400 + LOOP); 
278 NEXT LOOP 


The Status register needs to be transferred into a memory location so that it can be 
manipulated. To do this, it must first be pushed onto the stack (line 90), then pulled into 
the accumulator (line 160) and then it can be stored in the user area (line 110). The X 
register is used to count the eight bits of the status byte, so it is initialized accordingly in 
line 120. The arithmetic shift left (line 130) moves the most significant bit of #400 into the 
Carry flag. The accumulator is loaded with #00 (line 140) and then the ADC instruction 


(line 15@) is used to add @ to it! No I haven't gone barmy, remember the Carry flag is taken 
into consideration during the ADC operation, therefore if it is set by the shifting 
procedure, the accumulator will now contain | (otherwise it will not be altered). Anyway, 
the result is saved in the user area (line 160) using indexed addressing. Because the X 
register was originally set to 8, and is also being used as the indexing register, the result of 
each shift operation is saved in reverse order. The loop is executed eight times while the X 
register is being decremented to zero. On returning to BASIC, the valuc of each flag is 
displayed by using a negative loop to extract the bit values from the user area. 

To prove that the program really does work you might like to include a flag changing 
instruction inside the program. For example: 


85 DATA #A9, #FF : REM LDA @i#FF set N clear Z 
or: 


85 DATA #A9, #00 : REM LDA @#@6 clear N set Z 


These will condition the flags as indicated in the REMs; remember to increase the ‘DATA- 
loading’ loop count by the extra number of bytes you insert (two in the above examples). 


BIT 


The instruction, BIT, allows individual bits of a specified memory location to be tested. It 
has an important feature in that it does nor change the contents of either the accumulator 
or the memory location being tested, but, as you may have guessed, it conditions various 
flags within the Status register. Thus: 


1. The Negative flag is loaded with the value of bit 7 of the location being tested. 

2. The Overflow flag is loaded with the value of bit 6 of the location being tested. 

3. The Zero flag is set if the AND operation between the accumulator and the memory 
location produces a zero. 


By loading the accumulator with a mask it is possible to test any particular bit oka 
memory location. For example, to test location TEMP to see if bit @ is clear the following 
could be used: 


LDA @3#1 \ 00000001 
BIT TEMP \ test bit @ 


If bit 6 of TEMP contains a @, the Zero flag will be set, otherwise it will remain clear, thus 
allowing BNE and BEQ to be used for testing purposes. 

This masking procedure need only be used for testing bits @ to 5 because bits 6 and 7 are 
automatically copied into the Negative and Overflow flags, which have their own test 
instructions. 


BIT TEMP 

BMI \ branch if bit 7 set 
BPL \ branch if bit 7 clear 
BVC \ branch if bit 6 set 
BVS \ branch if bit 6 clear 
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[5 Multiplication and Division 


MULTIPLICATION 


Performing multiplication in machine code is not too difficult provided that you 
have grasped what you have read so far. Unfortunately there are no multiplication 
instructions within the Oric'’s 6502 instruction set, therefore it is necessary to develop an 
algorithm to carry out this procedure. 

Let’s first look at the simplest method of multiplying two small values together. 
Consider the multiplication 5 < 6. We know the result is 30, but how did we obtain this? 
Simply by adding together six lots of five, in other words: 5 +5+5+5+5+5= 30. 
This is quite easy to implement: 


Program 25 

10 REM * * SIMPLY MULTIPLY * * 

20 REM * * HIMEM 49600 * * 

38 CODE = #9608 

49 FOR LOOP = @ TO 19 

5@ READ BYTE 

68 POKE CODE + LOOP, BYTE 

78 NEXT LOOP 

80 

99 REM * * M/C DATA * * 
100 DATA #A9, #60 * REM LDA @#@ 
110 DATA 48D, #00, #04 : REM STA #400 
120 DATA #A2, #06 : REM LDX @#6 
130 DATA #18 : REM CLC 
140 DATA #AD, #60, #04 : REM LDA #400 
158 DATA #69, #05 : REM ADC @#5 
16@ DATA #8D, #00, #04 : REM STA #460 
176 DATA #CA : REM DEX 
188 DATA #D8@, #F5 : REM BNE -11 
199 DATA #60 : REM RTS 
200 


210 REM * * SET UP & EXECUTE * * 
220 CLS 


238 CALL (CODE) 
240 PRINT PEEK (#400) 


All we have done here is to create a loop to add 5 to the contents of location #400 six times 
to produce the desired result! This method is reasonable for multiplying small values, but 
not particularly efficient for larger numbers. 

At this point, it might be worth reviewing the usual procedure for multiplying two large 


decimal numbers together. Consider 123 X 150. We would approach this, (without 
calculators, please!) thus: 


123 (Multiplicand) 
x150 (Multiplier) 


000 (Partial product 1) 
615 (Partial product 2) 
123 (Partial product 3) 


18450 (Result or final product.) 





The initial two values are termed the multiplicand and multiplier, and their product is 
formed by multiplying, in turn, each digit in the multiplier by the multiplicand. This 
results in a partial product, which is written such that its least significant digit sits directly 
below the multiplier digit to which it corresponds. When formation of all the partial 
products is completed, they are added together to give the final product or result. 


We can apply this technique to binary numbers, starting off with two three bit values, 
010 x O11 


010 (Multiplicand) 
x@11 (Multiplier) 


016 (Partial product 1) 
010 (Partial product 2) 
000 (Partial product 3) 


00110 (Result) 





Ignoring leading zeros, we obtain the result 110 (2 X 3 = 6). Moving on to our original 
decimal example, its binary equivalent is: 


@1111011 123(#7B) 
xX10010116 156(#96) 


00000000 
@1111011 
O1111011 
00000000 
@1111011 
000000000 
00000000 
@1111011 


100160000010010 18450(#4812) 


Hopefully you will have noticed that if the multiplier digit is a @ it will result in the whole 
partial product being a line of zeros (anything multiplied by zero is zero). Therefore ifa@ 
is present in the multiplier it can simply be ignored bur we must remember to shift the next 
partial product up past any Qs so that its least significant digit still corresponds to the 
correct | of the multiplier. This technique of shifting and ignoring can be used to write an 
efficient multiplication program. 
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Program 26 


18 REM * * SINGLE BYTE MULTIPLICATION * * 

28 REM * * GIVING A TWO BYTE ANSWER * * 

38 REM * * ENTER HIMEM #9600 FIRST * * 

40 REM * * BEFORE RUNNING THIS PROGRAM * * 
50 CODE = #9600 

68 REPEAT 

70 READ BYTE 

80 POKE CODE + OFFSET, BYTE 

90 OFFSET = OFFSET + 1 

1006 UNTIL BYTE = #60 


110 

12@ REM * * M/C DATA * * 

130 

148 DATA #A2, #08 : REM LDX @8 
15@ DATA #A9, #00 : REM LDA @@ 
166 DATA #46, #71 : REM LSR #71 
170 DATA 490, #03 : REM BCC +3 
180 DATA #18 : REM CLC 

198 DATA 465, 470 : REM ADC 470 
200 DATA #6A : REM RORA 
210 DATA #66, 472 : REM ROR #72 
2206 DATA #CA >: REM DEX 
236 DATA #D®, #F3 : REM BNE -12 
240 DATA #85, #73 : REM STA 473 
250 DATA #60 : REM RTS 

260 

270 REM * * SET UP & RESULT * * 

280 CLS 


298 INPUT “MULTIPLICAND *; MCAND 
300 POKE #70, MCAND 

310 INPUT “MULTIPLIER ”; MLIER 

320 POKE #71, MLIER 

338 CALL (CODE) 

340 PRINT “RESULT IS :”; 

350 PRINT DEEK (#72) 


This program takes two single byte numbers, multiplies them together storing the result 
(which may be 16 bits long) in zero page. Unlike the binary multiplication examples, it 
does not compute each partial product before adding them together, but totals the partial 
products as they are evaluated. This is a somewhat quicker method, because the final 
product is generated as soon as the last bit of the multiplier has been examined. 


DIVISION 


When performing the division of one number by another, we are actually calculating the 
number of times the second number can be subtracted from the first. Consider 125 + 5: 
25 (Quotient) 


(Divisor) S25 (Dividend) 
—-10 


25 
Zo 


4) (Remainder) 


Here, 5 can be subtracted from 10 twice, so we note the value 2 as part of the quotient. 
The 10 is brought down and subtracted from the first two digits of the dividend, leaving 2. 
Because 5 cannot be subtracted from 2 the remaining 5 of the dividend is brought down to 
give 25. S$ can be subtracted from this, without remainder, 5 times. Again this is recorded 
in the quotient, which now reflects the final result. 


To divide binary numbers, this same procedure is pursued. The above example in 
binary would look like this: 


00011001 


O1GLIOLII1II01 
0101 


In fact, as you may see, dividing binary numbers is much simpler than dividing decimal 
numbers. If the divisor is less than or equal to the dividend the corresponding bit in the 
quotient will be a |. If the subtraction is not possible a @ is placed in the quotient, the next 
bit of the dividend is brought down, and the procedure repeated. 


The following utility program divides two single byte values and indicates whether a 
remainder is present: 


Program 27 


10 REM * * SINGLE BYTE DIVIDE * * 

20 REM * * GIVING A TWO BYTE ANSWER * * 

30 REM * * ENTER HIMEM #9600 FIRST * * 

40 REM * * BEFORE RUNNING THIS PROGRAM * * 
5@ CODE = #9600 

66 REPEAT 

70 READ BYTE 

86 POKE CODE + OFFSET, BYTE 

90 OFFSET = OFFSET + 1 
106 UNTIL BYTE = #60 
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110 
126 
130 
146 
150 
168 
170 
180 
198 
200 
210 
220 
230 
240 
250 
260 
270 
280 
298 
3068 
318 
320 
330 
340 
350 
360 
370 


REM * * M/C DATA * * 


DATA #A2, #08 REM LDX @8 
DATA #A9, #00 REM LDA @0 
DATA #06, #71 REM ASL #71 
DATA #2A REM ROLA 
DATA #CS, #70 REM CMP #70 
DATA #90, #04 REM BCC +4 
DATA #ES, #76 REM SBC #70 
DATA #E6, #71 REM INC 471 
DATA #CA REM DEX 
DATA &#D®@, #F2 REM BNE -—13 
DATA #85, #72 REM STA #72 
DATA #60 REM RTS 


REM * * SET UP & RESULT * * 
CLS 

INPUT “DIVIDEND "; DEND 
POKE #70, DEND 

INPUT “DIVISOR “; DSOR 
POKE #71, DSOR 

CALL (CODE) 

PRINT “RESULT IS :”; 
PRINT PEEK (#71) 

PRINT “REMAINDER :”; 
PRINT PEEK (#72) 


This program uses the shift instructions of lines 16@ and 17@ as a two byte shift register 
in which the accumulator acts as the higher byte. The carry produced by ROL A is 
insignificant, in fact it is ®, and is eroded by the next ASL #71 procedure. 


Ices 


Append 
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| ASCH Codes 


The ‘American Standard Code for Information Interchange’ (no wonder it’s shortened to 
ASCII!), is used by virtually all microcomputers as a way of coding letters and a range of 
‘control characters’ so that they may be handled by number conscious micros. 

The ASCII codes 9-31 are known as the control codes, as they are used to control 
various aspects of the Oric's operation. 


Table Al.1 


Decimal Hex Meaning 


0 Q NUL—Do nothing! 
] | CTRLA 
2 2 
3 3 Interrupt 
4 4 Double height on/off 
5 5 
6 6 Keyclick on/off 
7 7 Bleep internal speaker 
8 8 Move text cursor back a single space 
9 9 Move text cursor forward a single space 
10 A Line feed 
11 B Vertical tab (move up a single line) 
12 Cc Clear text area 
13 D Carriage return (cursor to start of line) 
14 E Delete row 
15 F 
16 10 Printer on/off 
17 11 Cursor on/off 
18 12 
19 13 Screen on/off 
20 14 
21 15 
22 16 
23 17 
24 18 Cancel line 
25 19 
26 1A 
27 1B 
28 1C 
29 1D Inverse on/off 
30 1E 
31 IF 





The numbers 32-127 are used to define letters, numbers and punctuation marks, and are 
detailed in Table A1.2. 


Table Al.2 

Decimal Hex ASCII Decimal Hex ASCII 
32 20 (space) 8] 51 Q 
33 21 ! 82 52 R 
34 22 s 83 53 S 
35 23 H 84 54 T 
36 24 $ 85 55 U 
37 25 % 86 56 Vv 
38 26 & 87 57 WwW 
39 27 : 88 58 Xx 
40 28 ( 89 59 Y 
41 29 ) 98 SA Zz 
42 2A * 91 5B [ 
43 2B + 92 5C \ 
44 2C - 93 5D ] 
45 2D 94 SE 7 
46 2E , 95 5F 3 
47 2F / 96 60 © 
48 30 i) 97 61 a 
49 31 l 98 62 b 
50 32 2 99 63 c 
51 33 3 100 64 d 
52 34 4 101 65 e 
53 35 5. 162 66 f 
54 36 6 103 67 2 
55 37 7 104 68 h 
56 38 8 105 69 i 
57 39 9 106 6A j 
58 3A : 107 6B k 
59 3B 7 108 6C ] 
60 3C < 109 6D m 
61 3D = 110 6E n 
62 3E > 111 6F oO 
63 3F ? 112 70 Pp 
64 40 @ 113 71 q 
65 4] A 114 72 r 
66 42 B 115 73 s 
67 43 Cc 116 74 t 
68 44 D 117 75 u 
69 45 E 118 76 Vv 
70 46 F 119 77 w 
71 47 G 120 78 x 
72 48 H 121 79 y 
73 49 I 122 TA z 
74 4A J 123 7B ( 
75 4B K 124 7C ' 
76 4C L 125 7D ) 
77 4D M 126 7E 
78 4E N 127 7F delete 
79 4F O 128 80 
80 50 P 129. 81 
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2 The 6502 


So far throughout this book we have been concerned with the software aspects of the 
Oric’s 6502, or in other words, how to program it! We could not really finish without 
having a glimpse at its hardware or physical features. For example, just how is it organized 
internally and how does it transfer data to and fro? While it is not absolutely vital to 
understand these features, an understanding of its design will enhance your new found 
knowledge. 

Figure A2.1 shows a simplifed block diagram of the 6502's design or architecture as it is 
more commonly called. If you study it many of the features will be readily recognizable. 
There are a few exceptions though, including three buses, the address bus, the data bus, 
and the control bus. You may well be wondering just what is meant by bus? It is not, as you 
may have thought, a number 19 bound for Highbury Barn—it’s simply a collective term 
for a series of wires—or tracks as they are called on a Printed Circuit Board (PCB for 
short)—onto which a | or a @ can be placed electronically. 

By placing a series of Is and @s onto the eight lines of the data bus, a byte of information 
may be transferred to or from the address specified by the binary value present at that 
instant in time on the 16 lines of the address bus. 

The control bus lines are responsible for carrying the numerous synchronization signals 
that are required for the Oric to operate. 


EXECUTING INSTRUCTIONS 


We can now examine just how the 6502 fetches, interprets and executes each instruction. 
Firstly, the 6502 must locate and read the next instruction of the machine code program. It 
does this by placing the current contents of the Program Counter onto the address bus and 
simultaneously placing a read signal on the appropriate contro! bus line. Almost 
instantaneously the instruction, or more correctly the byte that constitutes the instruction, 
is placed onto the data bus. The 6502 then reads the contents of the data bus intoa special 
internal, eight bit register, known as the Instruction Register (IR for short), which is used 
exclusively by the 6582 to hold data waiting for processing. Once in the IR, the Control 
Unit interprets the instruction and then generates the various internal and external signals 
required to execute the instruction. For example, if the data byte fetched was #A5, the 
652 would interpret this as LDA zero page, and would fetch the next byte of data and 
interpret this as the address at which the data to be placed into the accumulator is located. 
Each one of these operations would be performed in a manner similar to that already 
described. 

Obviously instructions and data must be fetched in the correct sequence. To enable this 
to happen the Program Counter is provided with an automatic incrementing device. Each 
time the Program Counter’s contents are placed onto the address bus the incrementer 
adds one to its contents, thus ensuring bytes are fetched and stored in the correct order. 
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3 fhe instruction Set 


This section contains a full description of each of the 56 instructions that the 65@2 is 
provided with. For ease of reference, the instructions are arranged in alphabetical order 
by mnemonic, and each description is broken down into the following six sections: 


Introduction A brief one or two line description of the instruction’s function. 


Table This details the addressing modes available with the instruction, and lists the 
various opcodes, the total number of memory bytes required by each addressing mode, 
and finally the number of cycles that particular addressing mode takes to complete. 


Stams Shows the effect the execution of the instruction has on the Status register. The 
following codes are employed: 


* The flag is affected by the instruction but bits are undefined, being dependent 
on the byte’s contents 

1 The flag is set by the instruction 

®@ The flag is cleared by the instruction 


If no code is indicated the flag remains unaltered by the instruction. 


Operation A brief description of how the instruction operates together with details of its 
effect on the Status register. 


Applications Some hints and tips on the sort of applications the instruction might be 
used for. 


ADC 


Add memory to accumulator with carry. 


Addressing Opcode Bytes Cycles 
ADC @immediate #69 2 2 
ADC zero page #65 2 3 
ADC zero page, X #75 2 4 
ADC absolute #6D 3 4 
ADC absolute, X #7D 4 4/5 
ADC absolute, Y #79 3 4/5 
ADC (zero page, X) #61 2 6 
ADC (zero page). Y #71 2 S/f 


NV—BODIZC 


= = * 


Operation Adds the contents of the specified memory location to the current contents of 


the accumulator. If the Carry flag ts set this is added to the result which ts then stored in the 
accumulator. If the result is greater than #FF (255) the Carry flag ts set. If the result ts 
equal to zero the Zero flag ts set. The contents of bit 7 of the accumulator are copied into 
the Status register. If overflow occurred trom bit 6 to bit 7 the Overflow flag is set. 


Applications Allows single, double and multibyte numbers to be added together. 
Overflow from one byte to another 1s provided by the Carry flag which ts included in the 
addition. 
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AND 


Logical AND of memory location with accumulator. 








Addressing Opcode Bytes Cycles 
AND @immediate #29 2 2 
AND zero page #25 2 3 
AND zero page, X #35 2 4 
AND absolute #2D 3 4 
AND absolute, X #3D 3 4/5 
AND absolute, Y #39 3 4/5 
AND (zero page, X) #21 2 6 
AND (zero page), Y #31 2 5 





NV—BDIZC 
* 


Operation Logically ANDs the corresponding bits of the accumulator with the specified 
value or contents of memory location. The result of the operation is stored in the 
accumulator but memory contents remain unaltered. If the result of the AND is @, the 


Zero flag is set. If the result leaves bit 7 set, the Negative flag is set. Otherwise both flags are 
cleared. 


Applications Used to ‘mask off the unwanted bits of the accumulator. 


AND @#F®@ \ masks off lower nibble, 11116000 
AND @#@F \ masks off higher nibble, 60001111 


ASL 


Shift contents of accumulator or memory left by once bit. 








Addressing Opcode Bytes Cycles 
ASL accumulator HOA l 2 
ASL zero page #06 2 
ASL zero page, X #16 Zz 6 
ASL absolute HOE 3 6 
ASL absolute, X HIE 3 7 





NV—BDIZC 
ae 


* * 


Operation Shuffles the bits in a specified location one bit left. Bit 7 moves into the carry, 
and a zero is placed into the vacated bit 0. 





The Carry flag ts setif bit 7 contained a | before the shift, and cleared if it contained @. 
The Negative flag is set if bit 6 previously contained a 1. The Zero flag is set if the location 
holds #0@ after the shift. (For this to occur it must previously have contained either 400 
or #80). 


Applicanons Muttiplies the byte by two. Can be used to shift low nibble of byte into high 
nibble. 
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BCC 


Branch if the Carry flag is clear (C = @). 


Addressing Opcode Bytes Cycles 


BCC relative #90 2 2/3/4 


NV—BDIZC 


Operation If the Carry flag is clear (C = 6) the byte following the instruction is 
interpreted as a two’s complement number and ts added to the current contents of the 
Program Counter. This gives the new address from which the program will now execute, 
allowing a branch of cither 126 bytes back or 129 bytes forward. If the Carry flag is set 
(C = 1) the branch does not occur and the next byte ts ignored by the 65@2. 


Applications The Carry flag is conditioned by a number of instructions such as ADC, 
SBC, CMP, CPX and CPY, and a branch will occur if any of these result in clearing the 
flag. A ‘forced’ branch can be implemented using: 


CLC \ C=6 
BCC value \ Syump* 
BCS 


Branch if the Carry flag is set (C = 1). 


Addressing Opcodes Bytes Cycles 


BCS relative #BO 2 2/3/4 


NV—BDIZC 


Operation If the Carry flag is set (C = 1) the byte following the instruction is interpreted 
as a two's complement number and is added to the current contents of the Program 
Counter; this gives the new address from which the program will now execute, allowing a 
branch of cither 126 bytes back or 129 bytes forward. If the Carry flag is clear (C = @) the 
branch does not occur and the next byte is ignored by the 65@2. 


Applications As with BCC but the branch will only take place if an operation results in 
the Carry flag being set. A ‘forced’ branch can be implemented with: 


SEC \ C=1 
BCS set \ ‘jump* 


BEQ 


Branch if the Zero flag is set (Z = 1). 





Addressing Opcode Bytes Cycles 





BEQ relative 4FO 2 2/3/4 


NV—BDIZC 


Operation If the Zero flag is set (Z = |) the byte following the instruction is interpreted as 
a two's complement number and is added to the current contents of the Program Counter; 
this gives the new program address from which the program will now execute, allowing a 
branch of either 126 bytes back or 129 bytes forward. If the Zero flag is clear (Z = @) the 
branch does not occur and the next byte is ignored by the 6562. 





Applications Used to cause a branch when the Zero flag ts set. This happens when an 
operation results in zero (e.g. LDA @@). The BEQ command is used frequently after a 
comparison instruction, for example: 


CMP @*” 
BEQ Questionmark 


If the comparison succeeds the Zero Mag is set therefore BEQ will work. 


BIT 


Test memory bits. 


Addressing Opcode Bytes Cveles 
BIT zero page #24 2 3 
BIT absolute #2C 3 4 


NV—BDIZC 
_ * ¥ 


Operation The BIT operation affects only the Status register, the accumulator and the 
specified memory location are unaltered. Bit 7 and bit 6 of the memory byte are copied 
directly into N and V respectively. The Zero flag is conditioned after a logical bitwise 
AND between the accumulator and the memory byte. If accumulator AND memory 
results in zero then Z = 1, otherwise Z = @. 


Applications Often used in conjunction with BPL/BMI or BVS/BVC to test bits 7nd 6 
of a memory location and to cause a branch depending on their condition. 
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BMI 
Branch if the Negative flag is set (N = 1). 


i 


Addressing Opcode Bytes Cycles 





BMI relative #30 2 2/3/4 


NV—BDIZC 


Operation If the Negative flag is set (N = 1) the byte following the instruction is 
interpreted as a two's complement number and is added to the current contents of the 
Program Counter; this gives the new address from which the program will now execute, 
allowing a branch of either 126 bytes back or 129 bytes forward. If the Negative flag is 
clear (N = @) the branch does not occur and the next byte is ignored by the 6502. 





Applicanons Generally after an operation has been performed (i.e. LDA, LDX etc.) the 
most significant bit of the register is copied into the Negative flag position. If itis set thena 
branch will occur using BMI. The ‘minus’ part of the mnemonic denotes this instruction’s 
importance when using signed urithmetic—where bit 7 1s used to denote the sign of a 
number in two's complement form. 


BNE 


Branch if the Zero flag is clear (Z = @). 


Addressing Opcode Bytes Cycles 


BNE relative #DO 2 2/3/4 
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Operation If the Zero flag is clear (Z = @) the byte following the instruction is interpreted 
as a two’s complement number and is added to the current contents of the Program 
Counter; this gives the new address from which the program will now exccute, allowing a 
branch of either 126 bytes back or 129 bytes forward. If the Zero flag is set (Z = 1) the 
branch does not occur and the next byte is ignored by the 6502. 


Applications Used to cause a branch when the Zero flag is clear. It’s often used, in 
conjunction with a decrementing counter, as a loop controlling command. 


DEX 
BNE AGAIN 


will continue branching back to AGAIN until X = @ and the Zcro flag is set. 


BPL 


Branch if the Negative flag is clear (N = @). 





Addressing Opcode Bytes Cycles 





BPL relative #106 2 3/4/5 
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Operation If the Negative flag is clear (N = @) the byte following the instruction is 
interpreted as a two’s complement number and is added to the current contents of the 
Program Counter; this gives the new address from which the program will now execute, 
allowing a branch of cither 126 bytes back or 129 bytes forward. If the Negative flag is set 
(N = 1) the branch does not occur and the next byte is ignored by the 6582. 


Applications Generally after an operation has been performed (i.e. LDA, ROL, CPX 
etc.) the most significant bit of the register is copied into the Negative flag position. Ifit is 
clear then a branch will occur if BPL is used. The ‘plus’ part of the mnemonic denotes the 
instruction’s importance when using signed arithmetic, where bit 7 is used to indicate the 
sign of a number in two's complement form. If a decrementing counter is being used ina 
loop this branch instruction allows the loop to execute when the counter reaches zero. 


DEX 
BPL again 


This loop will finish when X is decremented from @ to #FF because #FF = 1111 L111 
binary, where bit 7 is set. 


BRK 


Software forced BREAK. 





Addressing Opcode Bytes Cycles 





BRK implied #00 | 7 


NV—BDIZC 
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Operation The Program Counter address plus one is pushed onto the stack, followed by 
the contents of the Status register. 





Applications Used as a software interrupt. This instruction should be avoided on the 
Oric as it will result in a ‘hang-up’! 
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BVC 


Branch if the Overflow flag is clear (V = @). 





Addressing Opcode Bytes Cycles 





BVC relative #50 2 2/3/4 
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Operation If the Overflow flag is clear (V = @) the byte following the instruction is 
interpreted as a two's complement number and added to the current contents of the 
Program Counter. This gives the new address from which the program will now exccute. 
This allows a branch of either 126 bytes back or 129 bytes forward. If the Overflow flag is 
set (V = 1) the branch does not take place and the next byte is ignored by the 6502. 





Applications Used to detect an overflow from bit 6 into bit 7 (i.¢c. a carry from bit 6 to bit 
7) when using signed arithmetic. When using signed arithmetic two numbers of opposite 
sign cannot overflow, however numbers of the same sign can overflow. For example: 


@1001111 (#4F) 
+ 081000000 (#40) 
10001111 (-#71) 


toned from bit 6 to bit 7 


The result is now negative which is, of course, absurd! Similarly adding two large negative 
numbers can produce a positive result. In fact overflow can occur in the following 
situations: 


1. Adding large positive numbers. 
2. Adding large negative numbers. 
3. Subtracting a large negative number from a large positive number. 
4. Subtracting a large positive number from a large negative number. 


The Overflow flag is used to signal this overflow from bit 6 to bit 7 and therefore, in 
signed arithmetic, a change in sign. If it is clear no overflow has occurred and BVC will 
cause a branch. 

A ‘forced’ branch may be implemented using: 


CLV \ clear V 
BVC Forced \ ‘jump’ 


BVS 


Branch if the Overflow flag is sct (V = 1). 





Addressing Opcode Bytes Cycles 
BVS relative #70 2 2/3/4 
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Operation If the Overflow flag is set (V = 1) the byte following the instruction is 
interpreted as a two's complement number and added to the current contents of the 
Program Counter. This gives the new address from which the program will now execute, 
allowing a branch of cither 126 bytes back or 129 bytes forward. If the Overflow flag is 
clear (V = @) the branch does not occur and the next byte is ignored by the 6582. 


Applications Used to cause a branch if the sign of a number has been changed. In most 
instances this will only matter if signed arithmetic is being employed. See BVC for more 
details. 


CLC 


Clear the Carry flag (C = @). 


Addressing Opcode Bytes Cycles 





CLC implied #18 I 2 


NV—BDIZC 
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Operation The Carry flag is cleared by setting it to zero. 





Applications Should always be used before adding two numbers together as the Carry 
flag’s contents are taken into account by ADC. A ‘forced’ branch may be implemented 
with: 


CLC \ Clear C 
BCC clear \ and ‘jump’ 
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CLD 


Clear the Decimal flag (D = 8). 





Addressing Opcode Bytes Cycles 





CLD implied #D8 l 2 





NV—BDIZC 
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Operation The Decimal flag is cleared by setting it to zero. 


Applications Used to make 6502 work in normal hexadecimal mode as opposed 
to decimal mode. 


CLI 


Clear the Interrupt Nag (I = 0). 


Addressing Opcode Bytes Cycles 
CLI implied #58 I 2 
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Operation The Interrupt flag is cleared by setting it to zero. 


Applications Causes any interrupts on the IRQ line to be processed immediately after 
completion of current instruction. 


CLV 


Clear the Overflow flag (V = 8). 





Addressing Opcode Bytes Cycles 





CLV implied #B8 1 


NV—BDIZC 
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Operation The Overflow flag is cleared by setting it to zero. 


2 





Applications Used to clear the Overflow flag after an overflow from bit 6 to bit 7. In most 
instances this is only important if signed arithmetic is being used. 
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CMP 


Compare contents of memory with contents of the accumulator. 








Addressing Opcode Bytes Cycles 
CMP @immediate #C9 2 2 
CMP zero page #C5 2 3 
CMP zero page, X #DS5 2 4 
CMP absolute #CD 3 4 
CMP absolute, X #DD | 4/5 
CMP absolute, Y #D9 3 4/5 
CMP (zero page, X) #C1 2 6 
CMP (zero page), Y #D1 2 5/6 





NV—BODIZC 
.- * 


* 


Operation The contents of the specified memory location (or immediate value) are 
subtracted from the contents of the accumulator. The contents of the memory location 
and accumulator are NOT altered, but the Negative, Zero and Carry flags are conditioned 
according to the result of the subtraction. To perform this subtraction, the 6502 first sets 
the Carry flag and then adds the two's complement value of the memory location's 
contents to the accumulator’s contents. If both values are equal (memory = accumulator) 
the Zero flag is set and the Carry flag remains set. If the contents of memory are less than 
the accumulator (memory < accumulator) the Zero flag is cleared and the Carry flag set. If 
memory contents are greater than the accumulator (memory > accumulator) then both 
the Zero flag and Carry flag are cleared. If unsigned binary is being used the Negative flag 
is also set. If signed binary is being used the Overflow flag should be checked in 
conjunction with the Negative flag to test for a ‘true’ negative result. 


Applications Should be used to test for intermediate values that cannot be tested directly 
from the Status register. For example: 


CMP @#00 
BEQ AWAY 


is a waste of two bytes, as the Zero flag will be set if the accumulator contains #00, 
therefore all that is needed is : BEQ AWAY. 


CPX 


Compare contents of memory with contents of the X register. 


Addressing Opcode Bytes Cycles 
CPX @immediate HEO 2 2 
CPX zero page HES 2 | 
CPX absolute HEC b 4 
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Operation The contents of the specified memory location (or immediate value) are 
subtracted from the contents of the X register. The contents of the memory location and X 
register are NOT altered, instead the Negative, Zero and Carry flags are conditioned 
according to the result of the subtraction. To perform this subtraction the 6502 first sets 
the Carry flag and then adds the two's complement value of the memory location to the 
contents of the X register. If both values are equal (memory = X register) the Zero flag is 
set and the Carry flag remains set. If the contents of memory arc less than the X register 
(memory < X register) the Zero flag is cleared but the Carry flag remains set. If memory 
contents are greater than the X register (memory > X register) then both Zero and Carry 
flags are cleared. If unsigned binary is being used then the Negative flag is set. 


Applications Should be used to test for intermediate values which cannot be tested 
directly from the Status register. For example, to test the X register’s contents during use 
as a loop counter try: 


LDX @#E@ \ load X with #E@ 
AGAIN DEX \ decrement X 

CPX @#87 \ has X reached #87? 

BNE AGAIN \ no, go to AGAIN 
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CPY 


Compare contents of memory with contents of the Y register. 








Addressing Opcode Bytes Cycles 
CPY @immediate #CO 2 2 
CPY zero page #C4 2 3 
CPY absolute &#CC 3 4 


NV—BDIZC 
bd 
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Operation The contents of the specified memory location (or immediate value) are sub- 
tracted from the contents of the Y register. The contents of the memory location and Y 
register are NOT altered, instead the Negative, Zero and Carry flags are conditioned 
according to the result of the subtraction. To perform this subtraction the 6582 first sets 
the Carry flag and then adds the two's complement value of the memory location to the 
contents of the Y register. If both values are equal (memory = Y register) the Zero flag is 
set and the Carry flag remains set. If the contents of memory are less than the Y register 
(memory < Y register) the Zero flag is cleared but the Carry flag remains set. If memory 
contents are greater than the Y register (memory > Y register) then both Zero and Carry 
flags are cleared. If unsigned binary is being used then the Negative flag Is set. 


Applications Should be used to test for intermediate values which cannot be tested 
directly from the Status register. For example, to test the Y register’s contents during use 
as a loop counter try: 


LDY @#EO \ load Y with #E@ 
AGAIN DEY \ decrement Y 

CPY @#87 \ has Y reached #87? 

BNE AGAIN \ no, go to AGAIN 


DEC 


Decrement memory contents by one. 


Operation 


Applications 








Addressing Opcode Bytes Cycles 
DEC zero page #C6 2 5 
DEC zcro page, X #D6 2 6 
DEC absolute HCE 3 6 
DEC absolute, X HDE 3 7 
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The byte at the address specified is decremented by one (MEMORY = 
MEMORY -—1). If the result of the operation is zero the Zero flag will be set. Bit 7 of the 
byte is copied into the Negative flag. 


Used to subtract one from a counter stored in memory. 
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DEX 


Decrement contents of X register by one. 





Addressing Opcode Bytes Cycles 





DEX implied HCA l 2 


NV—BDIZC 
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Operation One is subtracted from the value currently held in the X register (X = X —1). If 
the result of the operation is zero the Zero flag will be set. Bit 7 is copied into the Negative 
flag (N = 0 if X< #80 ;,N = 1 if X >#7F). The Carry flag is not affected by the instruction. 





Applications Used with indexed addressing when the X register acts as an offset froma 
base address, allowing a sequential set of bytes to be accessed. Invariably used to 
decrement the X register when being used as a loop counter, branching until X = @ 
(Z= 1). 


DEY 


Decrement contents of Y register by one. 





Addressing Opcode Bytes Cycles 
DEY implied #88 l 2 


NV—BDZC 
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Operation One is subtracted from the value currently held in the Y register (Y = Y —1). If 
the result of the operation is zero the Zero flag is set. Bit 7 is copied into the Negative flag 
(N = 0 if Y < #80;N = 1 if Y > #7F). The Carry flag is not affected by the instruction. 


Applications Used with indexed addressing when the Y register acts as an offset froma 
base address allowing a sequential set of bytes to be accessed. Invariably used to 
decrement the Y register when being used as a loop counter, branching until Y = @ 
(Z = 1). 
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EOR 


Accumulator exclusively ORed with memory. 


Addressing Opcode Bytes Cycles 
EOR @immediate #49 2 2 
EOR zero page #45 2 3 
EOR zero page, X #55 2 4/5 
EOR absolute #4D 3 4 
EOR absolute, X #5D 3 4/5 
EOR absolute, Y #S9 3 4/5 
EOR (zero page, X) #4] 2 6 
EOR (zero page), Y #51 2 5/6 
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Operation Performs a bitwise exclusive OR between the corresponding bits in the 
accumulator and the specified memory byte. If the result, which is stored in the 
accumulator, is zero the Zero flag is set. Bit 7 is copied into the Negative flag. 


Applications Used to complement or invert a data byte. 


INC 


Increment memory contents by one. 


Addressing Opcode Bytes Cycles 
INC zero page #E6 2 5 
INC zero page, X #F6 2 6 
INC absolute #EE 3 6 
INC absolute, X #FE 3 7 


NV—BODIZC 
* * 


Operation The byte at the address specified is incremented by one. If the address holds 
zero after the operation the Zcro flag is set. Bit 7 of the byte is copied into the Negative 
flag. 


Applications Add one to a counter stored in memory. 
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INX 


Increment contents of X register by one. 





Addressing Opcode Bytes Cycles 





INX implied HE8 l 2 





NOV BoD ft 2.6 


Operation One is added to the value currently in the X register (X = X + 1). If the result 
of the operation is zero the Zero flag will be set. Bit 7 is copied into the Negative flag 
(N = Oif X << #80; N= 1 if X > #7F). The Carry fag is not affected by the instruction. 
Applicauons Used with indexed addressing when the X register acts as an offset from a 
base address, and allows a sequential set of bytes to be accessed. Often used as a counter 
to control the number of times a loop of instructions is executed. 


INY 


Increment contents of Y register by one. 


Addressing Opcode Bytes Cycles 


INY implied #C8 l 2 
NV—BDIZC 


Operation One is added to the value currently held in the Y register (Y = Y + 1). If the 
result of the operation is zero the Zero flag will be set. Bit 7 is copied into the Negative flag. 
The Carry flag is not affected. 


Applications Used with indexed addressing when the Y register acts as an offset froma 
base address, allowing a sequential set of bytes to be accessed. Often used as a counter to 
control the number of times a loop is executed. 


JMP 


Jump to a new location. 





Addressing Opcode Bytes Cycles 
JMP absolute #4C 3 3 
JMP (indirect) #6C 3 3 
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Operation Inanabsolute JMP the two bytes following the instruction are placed into the 
Program Counter. In an indirect jump the two bytes located at the two byte address 
following the instruction are loaded into the Program Counter. 


Applications Transfers control, unconditionally, to another part of a program stored 
anywhere in memory. 


JSR 


Jump, save return address. 


Addressing Opcode Bytes Cycles 





JSR absolute #20 3 6 
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Operation Acts as a subroutine call, transferring program control to another part of 
memory until an RTS is encountered. The current contents of the Program Counter plus 
two are pushed onto the stack. The Stack Pointer is incremented twice. The absolute 
address following the instruction is placed into the Program Counter and program 
execution continues from this new address. 


Applications Allows large repetitive sections of programs to be entered once, out of the 
way of the main program, and called as subroutines as often as required. 
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LDA 


Load the accumulator with the specified byte. 


ee ee ee ET ee 
Addressing Opcode Bytes Cycles 
LDA @immediate #AS 2 2 
LDA zero page #A5 2 3 
LDA zero page, X #B5 2 4 
LDA absolute #AD 3 4 
LDA absolute, X #BD 3 4/5 
LDA absolute, Y #B9 3 4/5 
LDA (zero page, X) HAI 2 6 
LDA (zero page), Y #Bl 2 5/6 





NV—BDIZC 
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Operation Places the value immediately following the instruction, or the contents of the 
location specified after the instruction, into the accumulator. If the value loaded is zero 
then the Zero flag is set. Bit 7 is copied into the Negative flag position. 


Applications Probably the most frequently used instruction, it allows for general data 
movement and facilitates all logical and arithmetic operations. 


LDX 


Load the X register with the specified byte. 





Addressing Opcode Bytes Cycles 
LDX @immediate #A2 2 2 
LDX zero page #A6 2 3 
LDX zero page, Y #B6 2 4 
LDX absolute #AE 3 4 
LDX absolute, Y #BE 3 4/5 
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Operation Places the value immediately following the instruction, or the contents of the 
location specified after the instruction, into the X register. If the value loaded is zero then 
the Zero flag is set. Bit 7 is copied into the Negative flag position. 


Applications General transfer of data for processing or storage. Also allows a loop 
counter to be set to its start value. 


LDY 


Load the Y register with the specified byte. 


Addressing Opcode Bytes Cycles 
LDY @immediate HAO 2 2 
LDY zero page #A4 2 3 
LDY zero page, X #B4 2 4 
LDY absolute #AC 3 4 
LDY absolute, X #BC 3 4/5 


NV—BDIZC 
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Operation Places the value immediately following the instruction, or the contents of the 
location specified after the instruction, into the Y register. If the value loaded is zero the 
Zero flag is set. Bit 7 is copied into the Negative flag. 


Applications General transfer of data for processing or storage. Also allows a loop 
counter to be set to its start value. 
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LSR 


Logically shift the specified byte right one bit. 








Addressing Opcode Bytes Cycles 
LSR accumulator #4A l 2 
LSR zero page #46 2 5 
LSR zero page, X #56 2 6 
LSR absolute H4E 3 6 
LSR absolute, X #5E 3 7 


NV—BDtIZ@C 
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Operation Moves the contents of the specified byte right by one position, putting a @in 
bit 7 and bit @ into the Carry flag. 





The Negative flag is cleared, and the Carry flag is conditioned by the contents of bit @. The 
Zero flag is set if the specified byte now holds zero (in which case 1t must previously have 
contained #00 or #61). 


Applications Divides a byte value by two (if D = @) with its remainder shifting into the 
Carry flag position. Can also be used to shift the high nibble of a byte into the low nibble. 


NOP 


No operation. 


Addressing Opcode Bytes Cycles 
NOP implied #EA 1 2 


NV—BDIZC 


Operation Does nothing except increment the Program Counter. 


Applications Provides a two cycle delay. 
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ORA 


Logical OR of a specified byte with the accumulator. 


Addressing Opcode Bytes Cycles 
ORA @immcdiate #69 2 2 
ORA zero page #05 2 3 
ORA zero page, X #15 2 4 
ORA absolute #6D 3 4 
ORA absolute, X #1D 3 4/5 
ORA absolute, Y #19 3 4/5 
ORA (zero page, X) #61 2 6 
ORA (zero page), Y #11 2 3 
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Operation Logically ORs the corresponding bits of the accumulator with the specified 
value, or contents of a memory location. The result of the operation is stored in the 
accumulator. If the result leaves bit 7 set the Negative flag is set, otherwise it is cleared. 


Applications Used to ‘force’ certain bits to contain a one. For example: 
ORA @#806 \ 10006060 binary 
will ensure bit 7 is set. 


PHA 
Push the accumulator contents onto the ‘top’ of the stack. 


Addressing Opcode Bytes Cycles 
PHA implied #48 l 3 


NV—BDIZC 


Operation Thecontents of the accumulator are copied into the position indicated by the 
Stack Pointer. The Stack Pointer is then decremented by one. 





Applications Allows bytes of memory to be saved temporarily. The index registers can 
be saved by first transferring them to the accumulator; memory bytes are saved by first 
loading them into the accumulator. Bytes are recovered with PLA. 
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PHP 


Push the Status register’s contents onto the top of the stack. 


Addressing Opcode Bytes Cycles 
PHP implied #O8 l 3 


NV—BDIZC 


Operations The contents of the Status register are copied into the position indicated by 
the Stack Pointer. The Stack Pointer is then decremented by one. 


Applications Allows the conditions of the flags to be saved, perhaps prior toa subroutine 
call, so that the same conditions can be restored with PLP on return. 


PLA 


Pull the ‘top’ of the stack into the accumulator. 





Addressing Opcode Bytes Cycles 
PLA implied #68 I 4 


NV—BDIZC 
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Operation The Stack Pointer is incremented by one, and the byte contained at this 
position in the stack is copied into the accumulator. If the byte is #80 the Zero flag is set. 
Bit 7 is copied into the Negative flag. 


Applications Complements the operation of PHA to retrieve data previously pushed 
onto the stack. 
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PLP 


Pull the ‘top’ of the stack into the Status register. 





Addressing Opcode Bytes Cycles 
PLP implied #28 ] 4 


NV=—BDIZC 
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Operation ‘The Stack Pointer is incremented by one and the byte contained at this 
position is copied into the Status register. 


Applications Complements the operation of PHP to retrieve the previously pushed 
contents of the Status register, or to condition certain flags from a defined byte previously 


pushed onto the stack via the accumulator. 


111 


ROL 


Rotate either the accumulator or a memory byte left by one bit with the Carry flag. 





Addressing Opcode Bytes Cycles 
ROL accumulator H2A l 2 
ROL zero page #26 2 5 
ROL zero page, X #36 2 6 
ROL absolute #2E 3 6 
ROL absolute, X #3E 3 7 


NV—BDIZC 
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Operation The specified byte and the contents of the Carry flag are rotated left by one 
bit in a circular manner. 





Bit 7 is rotated into the Carry flag, with the flag’s previous contents moving into bit 0. The 
remaining bits are shuffled left. The Negative flag is set if bit 6 previously held 1; 
cleared otherwise. The Carry flag is conditioned by bit 7, and if the specified byte now 
holds zero the Zero flag is set. 


Applications Used in conjunction with ASL, ROL can be used to double the value of 
multibyte numbers, as the Carry bit is used to propagate the overflow from one byte to 
another. It may also be uscd before testing the Negative, Zero and Carry flags to 
determine the state of specific bits. 
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ROR 


Rotate either the accumulator or a memory byte right by once bit with the Carry flag. 








Addressing Opcode Bytes Cycles 
ROR accumulator #6A 1 2 
ROR zcro page #66 2 5 
ROR zero puge, X #76 2 6 
ROR absolute #6E 3 6 
ROR absolute, X #7E 3 7 


NV—BDIZC 
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Operation The specified byte and the contents of the Carry flag are rotated right by one 
bit in a circular manner. 





Bit @ is rotated into the Carry flag with the flag's previous contents moving into the bit 7 
position. The remaining bits are shuffled right. The Negative flag is set if the Carry flag 
was set previously; otherwise it is cleared. If bit @ contained a | the Carry flag will now also 
be set. If the specified byte now holds zero the Zero flag is set. 


Applications Used in conjunction with LSR, ROR can be used to halve the value of 


multibyte numbers. It may also be used before testing the Negative, Zero and Carry flags 
to determine the contents of specific bits. 
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RTI 
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Return from interrupt. 





Addressing Opcode Bytes Cycles 





RTI implied #40 1 6 





NV—BDIZC 
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Operation This instruction expects to find three bytes on the stack. The first byte is 
pulled from the stack and placed into the Status register—thus conditioning all flags. The 
next two bytes are placed into the Program Counter. The Stack Pointer is incremented as 
each byte is pulled. 


Applications Used to restore control to a program after an interrupt has occurred. On 
detecting the interrupt, the processor will have pushed the Program Counter and Status 
register onto the stack. 





RTS 

Return from subroutine. 
Addressing Opcode Bytes Cycles 
RTS implied #60 l 6 
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Operation The two bytes on the top of the stack are pulled, incremented by one, and 
placed into the Program Counter. Program execution continues from this address. The 
Stack Pointer is incremented by two. 


Applications Returns control from a subroutine to the calling program. It should 
therefore be the last instruction of a subroutine. 


SBC 


Subtract specified byte from the accumulator with borrow. 


Addressing Opcode Bytes 
SBC @immediate #E9 2 
SBC zero page HES 2 
SBC zero page, X HFS 2 
SBC absolute #ED é 
SBC absolute, X #FD 3 
SBC absolute, Y #F9 3 
SBC (zero page, X) #El 2 
SBC (zero page), Y #F1 2 
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* * * * 


Cycles 


a&hwh 


4/5 
4/5 


5/6 


Operation Subtracts the immediate value, or the byte contained at the specified address, 
from the contents of the accumulator. If the value is greater than the contents of the 
accumulator it will ‘borrow’ from the Carry flag, which should be set at the onset (only) of 
a subtraction. If the Carry flag is clear after the subtraction, a borrow has occurred. If the 
result is #00 the Zero flag is set. The contents of bit 7 are copied into the accumulator and 


V is set if an overflow from bit 6 to bit 7 occurred. 


Applications Allows single, double and multibyte numbers to be subtracted from one 


another. 


SEC 


Set the Carry flag (C = 1). 





Addressing Opcode Bytes 


Cycles 





SEC implied #38 l 


2 
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Operation A one is placed into the Carry flag bit position. 


Applications Should always be used at the onset of subtraction as the Carry flag is taken 


into account by SBC. 
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SED 


Set the Decimal mode flag (D = 1). 





Addressing Opcode Bytes Cycles 





SED implied HF8 | 2 


NV—BDIZC 
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Operation A one is placed into the Decimal flag position. 





Applications Puts the Beeb in decimal mode, in which Binary Coded Decimal (BCD) 
arithmetic is performed. The Carry flag now denotes a carry of hundreds. as the maximum 
value that can be encoded in a single BCD byte is 99. 


SEI 
Set the Interrupt disable flag (I = 1). 





Addressing Opcode Bytes Cycles 
SEI implied #78 l 2 
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Operation A one is placed into the Interrupt flag position. 


Applications When this flag is set o interrupts occurring on the IRQ line are processed. 
However NMI interrupts are processed, as are BREAKS. 
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STA 


Store the accumulator's contents in a memory location. 


Operations The contents of the accumulator are copied into the specified memory 


location. 


Applications 








Addressing Opcode Bytes Cycles 
STA zero page #85 2 3 
STA zero page, X H95 2 4 
STA absolute #8D 3 4 
STA absolute, X #9D 3 5 
STA absolute, Y #99 3 5 
STA (zero page, X) #81 2 6 
STA (zero page), Y #91 2 6 
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To save the contents of the accumulator, or to initialize areas of memory to 
specific values. Used inconjunction with LDA, blocks of data can be transferred from one 


area of memory to another. 


STX 


Store the X 


Operation 


Applications To save the X registers contents, or to initialize areas of memory to specific 


values. 


register’s contents in memory. 








Addressing Opcode Bytes Cycles 
STX zero page #86 z 3 
STX zero page, X #96 2 4 
STX absolute #8E 3 4 
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The contents of the X register are copied into the specified memory location. 
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STY 


Store the Y register’s contents in memory. 


a 


Addressing Opcode Bytes Cycles 
ne ee ee ee eee aL ie ea Seed 
STY zero page #84 2 3 
STY zero page, X #94 2 4 
STY absolute #8C 3 4 





NV—BODIZC 


Operations The contents of the Y register are copied into the specified memory location. 


Applications Tosave the Y register’scontents, or to initialize areas of memory to specific 
values. 


TAX 


Transfer the accumulator's contents into the X register. 


Addressing Opcode Bytes Cycles 


TAX implied #AA l 2 


NV—BDIZC 
* * 


Operation The contents of the accumulator are copied into the X register. If the X 
register now holds zero, the Zero flag is set. Bit 7 is copied into the Negative flag. 


Applications Allows the accumulator’s values to be saved temporarily, or perhaps used 
to seed the X register as a loop counter. Often used after PLA to restore the X register’s 
contents previously pushed onto the stack. 


TAY 


Transfer accumulator's contents into the Y register. 





Addressing Opcode Bytes Cycles 





TAY implied #A8 l 2 





NV—BDIZC 
s 


Operation The contents of the accumulator are copied into the Y register. If the Y 
register now holds zero the Zero flag is set. Bit 7 is copied into the Negative flag. 


Applications Allows the accumulator’s values to be saved temporarily, or perhaps used 


to seed the Y register as a loop counter. Often used after PLA to restore the Y register’s 
contents previously pushed onto the stack. 


TSX 


Transfer the Stack Pointer’s contents into the X register. 


Addressing Opcode Bytes Cycles 
TSX implied #BA | 2 


NV—BDIZC 
* * 


Operation The contents of the Stack Pointer are copied into the X register. If X now 
holds zero, the Zero flag is set. Bit 7 is copied into the Negative flag. 


Applications To calculate the amount of space left on the stack, or to save its current 
position while the stack contents are checked. 
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TXA 


Transfer the X Register’s contents into the accumulator. 





Addressing Opcode Bytes Cycles 





TXA implied #8A l 2 


NV—BDIZC 
* * 


Operation The contents of the X register are copied into the accumulator. If the 
accumulator now holds zero the Zero flag is set. Bit 7 is copied into the Negative flag. 





Applications Allows the X register’s contents to be manipulated by logical or 
arithmetic instructions. Followed by a PHA it allows the X register’s value to be saved on 
the stack. 


TXS 


Transfer the X Register's contents into the Stack Pointer. 


Addressing Opcode Bytes Cycles 


TXS implied HOA l 2 


NV—BDIZC 


Operation The contents of the X register are copied into the Stack Pointer. 


Applications Allows the contents of the Stack Pointer to be set or reset to a specific 
value. For example: 


LDX @#FF 
TXS 


will ‘clear’ the stack and reset the Stack Pointer. 


TYA 


Transfer the Y register's contents into the accumulator. 





Addresssing Opcode Bytes Cycles 





TYA implied 498 1 2 


NV—BDIZC 
* * 


Operation The contents of the Y register are copied into the accumulator. If the 
accumulator now holds zero the Zero flag is set. Bit 7 is copied into the Negative flag. 





Applications Allows the Y register’s contents to be manipulated by logical or arithmetic 
instructions. When followed by a PHA, it allows the Y register’s value to be saved on the 
stack. 
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4 Branch Calculators 


The branch calculators are used to give branch values in hex. First, count the number of 
bytes you need to branch. Then locate this number in the centre of the appropriate table, 
and finally, read off the high and low hex nibbles from the side column and top row 
respectively. 


Example _ For a backward branch of 16 bytes: 


Locate 16 in the centre of Table A4.1 (bottom row), then read off high nibble (#F) and low 
nibble (#0) to give displacement value (#F®). 


Table A4.1 Backward branch calculator 













128 127 126 125 124 123 122 121 126 119 118 117 116 115 114 113 
112 111 110 109 108 107 106 105 104 163 102 101 100 99 98 97 
96 95 94 93 92 91 96 89 88 87 86 85 84 83 82 81 
86 79 78 77 76 75 74 73 72 71 7 69 68 67 66 65 
64 63 62 61 60 59 58 57 S56 55 54 53 52 S51 50 49 
48 47 46 45 44 43 42 41 40 39 38 37 #36 35 34 33 
32 31 3@ 29 28 27 26 25 24 23 22 21 20 #19 18 17 
16 14 11 a a ae I 











MSD 
@ G.. tf 2 3 4 &2 & 7 8 98 16 i le wD 
] 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 
2 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 
3 48 49 5@ 51 52 53 54 55 56 57 58 S59 60 61 62 63 
4 64 65 66 67 68 69 7@ 71 72 73 74 75 76 77 78 79 
5 80 81 82 83 84 85 86 87 88 89 96 91 92 93 94 95 
6 96 97 98 99 100 101 102 103 104 105 106 107 108 169 11@ 111 
- 112 113 114 115 116 117 118 119 126 121 122 123 124 125 126 127 


5 65027 Opcodes 


All numbers are hexadecimal. 


86 BRK implied 

@1 ORA (zero page, X) 
@2 Future expansion 
@3 Future expansion 
@4 Future expansion 
@S ORA zero page 
@6 ASL zcro page 

07 Future expansion 
08 PHP implied 

69 ORA #immediate 
@A ASL accumulator 
@B Future expansion 
6C Future expansion 
@D ORA absolute 

@E ASL absolute 

@F Future expansion 
10 BPL relative 

11 ORA (zero page). Y 
12 Future expansion 
13. Future expansion 
14 Future expansion 
15 ORA zero page, X 
16 ASL zero page, X 
17. Future expansion 
18 CLC implied 

19 ORA absolute, Y 
1A Future expansion 


IB Future expansion 


Future expansion 
ORA absolute, X 
ASL absolute, X 
Future expansion 
JSR absolute 

AND (zero page, X) 
Future expansion 
Future expansion 
BIT zero page 
AND zero page 
ROL zero page 
Future expansion 
PLP implied 

AND #immediate 
ROL accumulator 
Future expansion 
BIT absolute 

AND absolute 
ROL absolute 
Future expansion 
BMI relative 

AND (zero page). Y 
Future expansion 
Future expansion 
Future expansion 
AND zero page, X 
ROL zero page, X 


Future expansion 
123 
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SEC implied 
AND absolute. Y 
Future expansion 
Future expansion 
Future expansion 
AND absolute, X 
ROL absolute, X 
Future expansion 
RTI implied 
EOR (zero page. X) 
Future expansion 
Future expansion 
Future expansion 
EOR zero page 
LSR zero page 
Future expansion 
PHA implied 
EOR #immediate 
LSR accumulator 
Future expansion 
JMP absolute 
EOR absolute 
LSR absolute 
Future expansion 
BVC relative 
EOR (zero page), Y 
Future expansion 
Future expansion 
Future expansion 
EOR zero page, X 
LSR zero page, X 
Future expansion 
CLI implied 

EOR absolute, Y 
Future expansion 
Future expansion 
Future expansion 
EOR absolute, X 
LSR absolute, X 


Future expansion 


65 
66 
67 
68 
69 
6A 
6B 
6C 
6D 
6E 
6F 
70 
71 
72 
#3 
74 
75 
76 
77 
78 
79 
7A 
7B 
7¢ 
7D 
7E 
TF 
80 
81 
82 
83 
84 
85 
86 
87 


RTS implied 
ADC (zero page, X) 
Future expansion 
Future expansion 
Future expansion 
ADC zero page 
ROR zero page 
Future expansion 
PLA implied 
ADC #immediate 
ROR accumulator 
Future expansion 
JMP (indirect) 
ADC absolute 
ROR absolute 
Future expansion 
BVS relative 
ADC (zero page). Y 
Future expansion 
Future expansion 
Future expansion 
ADC zero page, X 
ROR zero page, X 
Future expansion 
SEI implied 

ADC absolute, Y 
Future expansion 
Future expansion 
Future expansion 
ADC absolute, X 
ROR absolute, X 
Future expansion 
Future expansion 
STA (zero page, X) 
Future expansion 
Future expansion 
STY zero page 
STA zero page 
STX zero page 


Future expansion 


88 
89 
8A 
8B 
8C 
8D 
8E 
8F 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
9A 
9B 
9C 
9D 
9E 
oF 
A@ 
Al 
A2 
A3 
A4 
AS 
A6 
A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 


DEY implied 
Future expansion 
TXA implied 
Future expansion 
STY absolute 
STA absolute 
STX absolute 
Future expansion 
BCC relative 
STA (zero page), Y 
Future expansion 
Future expansion 
STY zero page, X 
STA zero page, X 
STX zero page, Y 
Future expansion 
TYA implied 
STA absolute, Y 
TXS implied 
Future expansion 
Future expansion 
STA absolute, X 
Future expansion 
Future expansion 
LDY #4immediate 
LDA (zero page. X) 
LDX #immediate 
Future expansion 
LDY zero page 
LDA zero page 
LDX zero page 
Future expansion 
TAY implied 
LDA #immediate 
TAX implied 
Future expansion 
LDY absolute 
LDA absolute 
LDX absolute 


Future expansion 


BO 
Bl 
B2 


B4 
BS 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BF 
Cé 
Cl 


C3 
C4 
C5 
C6 
C7 
C8 
C9 
CA 
CB 
cc 
CD 
CE 
CF 
DO 
DI 
D2 
D3 
D4 
DS 
D6 
D7 


BCS relative 

LDA (zero page). Y 
Future expansion 
Future expansion 
LDY zero page, X 
LDA zero page. X 
LDX zero page. Y 
Future expansion 
CLV implied 

LDA absolute. Y 
TSX implied 
Future expansion 
LDY absolute, X 
LDA absolute, X 
LDX absolute, Y 
Future expansion 
CPY #immediate 
CMP (zcro page, X) 
Future expansion 
Future expansion 
CPY zero page 
CMP zero page 
DEC zero page 
Future expansion 
INY implied 

CMP a4immediate 
DEX implied 
Future expansion 
CPY absolute 
CMP absolute 
DEC absolute 
Future expansion 
BNE relative 
CMP (zero page). Y 
Future expansion 
Future expansion 
Future expansion 
CMP zero page, X 
DEC zero page, X 


Future expansion 
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D8 CLD implied 


D9 

DA 
DB 
DC 


CMP absolute, Y 
Future expansion 
Future expansion 


Future expansion 


DD CMP absolute, X 


DE 
DF 


EB 


DEC absolute, X 
Future expansion 
CPX #immediate 
SBC (zero page, X) 
Future expansion 
Future expansion 
CPX zero page 
SBC zero page 
INC zero page 
Future expansion 
INX implied 
SBC 4immediate 
NOP implied 


Future expansion 


F7 
F8 
F9 


FB 
FC 
FD 
FE 
FF 


CPX absolute 
SBC absolute 
INC absolute 
Future expansion 
BEQ relative 
SBC (zero page), Y 
Future expansion 
Future expansion 
Future expansion 
SBC zero page, X 
INC zero page, X 
Future expansion 
SED implied 
SBC absolute, Y 
Future expansion 
Future expansion 
Future expansion 
SBC absolute, X 
INC absolute, X 


Future expansion 


6 The Oric’s Memory Map 


FFFF 






BASIC ROM 


Alternate character set 
Character set 


This RAM available 
if ‘GRAB’ issued 


BFE@ 











BB8¢@ 
B800 


B400 


——--------—---~—--——-———----- 9860 


Program area 






1/O addresses 
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General Index 


absolute addressing, 40 

absolute addressing associated 
instructions, 41 

absolute indexed addressing, 42, 43 

absolute indexed addressing associated 
instructions, 43 

addressing 
(see separate types) 

accumulator, 16 

accumulator associated instructions, 17 

ADC, 34, 35, 87 

addition 10, 11, 34, 35 

address bus, 84, 85 

addressing modes, 27 

AND, 88 

AND operation, 13, 14 

ASCII code, 82, 83 

ASL, 68, 73, 89 

assembler, 3 

assembly language, 3 


base, 5, 7 

BCC, 26, 90 

BCD mode, 25 

BCS, 26, 90 

BEQ, 59, 60, 91 

binary, 5 

binary addition 10, 11 

binary arithmetic, 10 

binary digit, 5 

binary division, 79, 80 

binary multiplication, 76, 77, 78 
binary print, 74, 75 

binary representation, 5 
binary subtraction, 11, 12, 13 
binary to decimal conversion, 6, 7 
binary to hex conversion, 7, 8 
bit, 5 

BIT, 75, 91 

BMI, 25, 92 

BNE, 57, 58, 92 

BPL, 25, 93 
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branch calculators, 122 
branches, 58, 59, 60 
Break flag, 25 

BRK, 93 

buses, 84, 85 

BVC, 94 

BVS, 95 

byte, 5, 33 


CALL, 23 

carry, 10, 12, 35 

Carry flag, 26 

CLOAD, 23 

CLC, 26, 35, 95 

CLD, 96 

CLI, 96 

CLV, 97 

CMP, 55, 98 

CODE, 19 

comparing, 55, 56 

conditional branches, 56 

control bus, 84, 85 

conversion, binary to hex, 7, 8 
hex to binary, 8 

counters, 54 

CPX, 55, 99 

CPY, 55, 100 


DATA, 18, 21 

data bus, 84, 85 

DEC, 60, 61, 101 
decimal, 5 

Decimal flag, 25 

decimal mode, 25 
decimal to binary conversion, 7 
decrementing memory, 61 
DEX, 54, 102 

DEY, 54, 102 
displacement, 58 
division, 79, 80 


EOR, 14, 15, 103 


fetch, 84 
flags, 24 
forcing, 14 


hash, 8 

hex, 7 

HEX$, 22 

hex codes, 8 

hexadecimal, 7 

hex to binary conversion, 8 
hex to decimal conversion, 9 
HIMEM, 20, 21 

HIRES, 20 


immediate addressing, 27, 28 

implied addressing, 31, 47 

INC, 60, 103 

incrementing memory, 61 

index registers, 17 

index registers associated 
instructions, 17 

indirect addressing, 44, 45 

instruction set, 86 

Interrupt flag, 25 

INX, 54, 104 

INY, 54, 104 

invert, 15 


JMP, 67, 105 
JSR, 62, 64, 65, 105 
jump, 67 


labels, 58 

LDA, 30, 106 

LDX, 30, 106 

LDY, 30, 107 

LIFO, 50 

load, 30 

logic, 13, 14, 15 
look-up tables, 48, 49 
loops, 54 

LSR, 68, 69, 73, 108 


machine code, 3 

machine code storage, 19-22 
masks, 16, 17 

memory, 127 

memory counters, 60, 61 
microprocessor, I, 84 
mnemonics, 3 

Monitor, 22 

multiplicand, 77 
multiplication, 69, 76, 77, 78 


negation, 39 
negative numbers, 24 
Negative flag, 25 
nibble, 8 

NOP, 109 


one’s complement, 12 

opcode, 3, 123 

operand, 27 

operation code, 3, 123, 124, 125, 126 
OR opcration, 14 

ORA, 109 

Overflow flag, 25 


paging, 32, 33 

partial product, 77 
parameters, 65, 66 

PC, 17 

PCH, 17 

PCL, 17 

PHA, 51, 52, 109 

PHP, 51, 53, 110 

PLA, 51, 52, 110 

PLP, 51, 53, 111 

POKE, 18 

post-indexed addressing, 45, 46 
power, 5 

pre-indexed addressing, 47 
printing binary, 74, 75 
processor status register, 24 
Program Counter, 17 

pull, 50 

push, 50 


READ, 21 

registers, 16, 17 

registers saving on stack, 51 
relative addressing, 47, 58 
REM, 18 

RESET, 23 

RETURN, 62 

ROL, 68, 71, 73, 112 
ROR, 68, 72, 73, 113 
rotate, 68, 84 

RTI, 114 

RTS, 62, 63, 64, 114 


SBC, 37, 38, 115 
SEC, 26, 37, 115 
SED, 116 
SEI, 116 
set, 6 
shift, 68 
sign, 11 
signed binary, 11, 12 
STA, 30, 117 
129 
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stack, 50-53, 64, 65 
Stack Pointer, 50 

Status, 24—26 

Status flags, 24 

Status register, 24 

store, 30, 31 

STX, 30, 117 

STY, 30, 118 
subroutines, 62 
subtraction, 11, 12, 37, 38 


table, hex codes, 8 
TAX, 31, 118 

TAY, 31, 119 

TEXT, 20 

transfer, 31 

TSX, 53, 119 

two’s complement, 12 
TXA, 31, 120 

TXS, 53, 120 

TYA, 31, 121 


vectors, 44 
weight, 5 


X register, 17 
X register associated instructions, 17 


Y register, 17 
‘Y register associated instructions, 17 


Zero flag, 26 
zero page addressing, 27, 28 
zero page indexed addressing, 41, 42 


6502, 84, 85 


Other titles of interest 
Easy Programming for the Oric-1 
Ian Stewart & Robin Jones 


Games to Play on your Oric-1 
Czes Kosniowski 


Brainteasers for BASIC Computers 
Gordon Lee 


Programming for REAL Beginners: Stage 1 
Philip Crookall 


Programming for REAL Beginners: Stage 2 
Philip Crookall 


Easy Programming for the Dragon 32 
Ian Stewart & Robin Jones 


Further Programming for the Dragon 32 
Ian Stewart & Robin Jones 


Dragon Machine Code 
Robin Jones & Eric Cowsill 


Easy Programming for the ZX Spectrum 
Ian Stewart & Robin Jones 


‘*... will take you a long way into the mysteries of the Spectrum: is 
written with a consistent and humorous hand: and shares the 
affection the authors feel for the computer’"—ZX Computing 


Further Programming for the ZX Spectrum 
Ian Stewart & Robin Jones 


Spectrum Machine Code 
Ian Stewart & Robin Jones 


Computer Puzzles: For Spectrum and ZX81 
Ian Stewart & Robin Jones 
‘What a gem of a book!’—Education Equipment 


Games to Play on Your ZX Spectrum 
Martin Wren-Hilton 


Spectrum in Education 
Eric Deeson 


PEEK, POKE, BYTE & RAM! Basic Programming 
for the ZX81 
Ian Stewart & Robin Jones 


Machine Code and better Basic 
Ian Stewart & Robin Jones 





£5.95 


£4.95 


£4.95 


£3.95 


£3.95 


£5.95 


£5.95 


£6.95 


£5.95 


£5.95 


£5.95 


£2.50 


£1.95 


£6.50 


£4.95 


£7.50 


Easy Programming for the BBC Micro 
Eric Deeson 


Further Programming for the BBC Micro 
Alan Thomas 


BBC Micro in Education 
Eric Deeson 


BBC Micro Assembly Language 
Bruce Smith 


Easy Programming for the Electron 
Eric Deeson 


Electron Assembly Language 
Bruce Smith 


Easy Programming for the Commodore 64 
Ian Stewart & Robin Jones 


Commodore 64 Assembly Language 
Bruce Smith 


Shiva Software 


BBC Micro Utilities 1 
Bruce Smith 


A machine code monitor plus a series of machine code subroutines. 


Spectrum Special 1 
Ian Stewart & Robin Jones 
A selection of 10 educational games and puzzles. 


Spectrum Specials 2 & 3 
Ian Stewart & Robin Jones 


The SHIVA First Mathematics Programme 
(for children 5-8 years) 
Developed by Iris V. Hewett, M. Ed. 


Each of the four tapes on numeracy and logic 
contains five graphically illustrated programs with 
full documentation. 


Lift off with Numbers Launching Logic 
Additional Fun Sets and Operators 
Cassettes are available for the BBC Micro Model B 


and versions for the Sinclair Spectrum and RML 480Z 
Microcomputers will follow soon. 


£5.95 


£5.95 


£6.50 


£7.95 


£5.95 


£7.95 


£6.95 


£7.95 


£6.95 


£5.95 


£5.95 each 








If you are NO longer boggled by BASIC, try being 


mesmer 


ized by machine code. 


Talk to your computer in its own jJanguage and see how much 
more quickly it responds. Find out how it uses: 

@ hexadecimal and binary 

e registers 

e absolute and indirect addressing 


e flags 
e shifts, rotates and jumps 
ves a full description 
ric’ 


This self-co 

machine co ct yailable to the 

and also Sug eon ator (ele Gee 
when and where machi routines cat. ; 
simple monitor pr provided to facilitate the entry of 
your machine cod 

Don’t let your Oric gather dust on the shelf — talk to it! 
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